About Roundcube

Why doesn't Roundcube work the same way as webmail X?

Roundcube aims to have an "application-like" interface, rather than a "webpage" interface. Because of this many behaviors that people are accustomed to seeing in webmail clients (such as single-clicking on a link to open a message) are intentionally very different in Roundcube. Roundcube attempts to leverage the power of Javascript to offer functionality that doesn't exist in any other webmail client but which we take for granted in even the most basic Windows or Macintosh application.

Squirrelmail/Horde/Illohamail? have X, why doesn't Roundcube provide X?

Roundcube is still in early development, so if you think a feature is missing, please get involved. Please get the Roundcube source from SVN and try to create a patch against the latest revision. It might be also a good idea to email our ​development mailinglist beforehand in case someone else is already working on it.

What is RoundCube?

• RoundCube is a mail client, just like Thunderbird, Outlook or Apple Mail.

What RoundCube is not?

• RoundCube is not a mailserver.
• RoundCube is not used to admin your mailserver.
• RoundCube does not create email accounts.

Common problems

Why am I getting blank page instead of the login page?

This is probably because your database is not set up correctly (did you run the included .sql script?) or is not working. Look in logs/errors for more details.

Another cause of a blank page -- especially when upgrading from an older version -- is a missing PHP module. A module may have been added as a requirement between releases, and if certain modules are missing it can lead to a blank page with no logged errors.

Why do I receive the following error: SERVICE CURRENTLY NOT AVAILABLE Error No.500)

Make sure your PHP installation has (Sqlite/Postgresql?/MySQL) support enabled and check your database setting in db.inc.php

Ensure that you have run the database initialization scripts that create the necessary tables/structure, or that they have been run by the installer.

Also, check to make sure that your db.inc.php file is readable by the web server process. Some documentation recommends chmod 600 db.inc.php but a chmod 644 db.inc.php under a differently configured system will be just as secure and will alleviate this error message.

Why aren't new messages shown in the message list or folder pane?

This is most likely because of RoundCube is caching your messages. Caching helps to reduce the strain upon your IMAP server, so fewer requests are required, and you can still read your mail. By turning this off, messages should appear almost instantaneously both in the folder-pane as well as the message list. See the 'enable_caching' property in your config/main.inc.php file.

Why am I not getting any spellcheck results? (or Why does spellchecking always mark every word as correct?)

Make sure you have both the OpenSSL and Socket modules for PHP enabled. The GoogieSpell plugin attempts to communicate with Google using SSL.

If this is the case, you may also be seeing an entry such as this in RoundCube's error log. (<roundcube_base>/logs/errors):

PHP Warning:  fsockopen() [function.fsockopen]: unable to connect to ssl://www.google.com:443 
  (Unable to find the socket transport "ssl" - did you forget to enable it when you configured PHP?) in <your_path>/program/steps/mail/spell.inc on line 34 

I upgraded, why is my folder view or page layout messed up?

The most common manifestation of this problem is when the search field is behind the roundcube logo. Cleaning your browser cache and reloading Roundcube will most likely resolve this issue.

I uploaded an attachment, why does it not attach?

The attachment size is probably exceeds the LimitRequestBody? directive set in your /etc/httpd/conf.d/php.conf file. Increase the limit and it should work.

When i click on an attachment a window appears that contains strange and senseless text, whats wrong?

If this is the case, you may also be seeing an entry such as this in RoundCube's error log. (<roundcube_base>/logs/errors):

PHP Warning: Cannot modify header information - headers already sent by (output started at <your_path>/config/main.inc.php) in <your_path>/program/steps/mail/get.inc on line 64

Check you main.inc.php and db.inc.php files in <roundcube_base>/conf and ensure there are no blank lines at the beginning or end.

I just re-installed roundcube, and when I log in, it doesn't fail but bring me back to the login page

This is because your browser still send the session cookie from the previous installation. Restart your browser so that the session cookie expire, and login again.

When receiving mail from Roundcube it keeps sending it from "apache@… send in behalf of user@…"

This could happen when you use Exim as a MTA. Be sure that the apache user is added to the trusted_users in exim.conf. Also be sure that the smtp_server-variable in de main.conf is empty to let Roundcube use the PHP-mailer.

Have answers to more questions?

Create an account on this platform and start editing this wiki page.