RoundCube Webmail is a browser-based multilingual IMAP client with an application-like user interface. It provides full functionality you expect from an e-mail client, including MIME support, address book, folder manipulation, message searching and spell checking. RoundCube Webmail is written in PHP and requires a MySQL or Postgres database. The user interface is fully skinnable using XHTML and CSS 2.

Download the source for Roundcube:

cd /extra/src
mkdir -p /var/websites/mail/htdocs /var/websites/mail/logs
tar zxf roundcubemail-1.3.7-complete.tar.gz
mv roundcubemail-1.3.7 /var/websites/mail/htdocs/roundcube
chown -R nobody:nobody /var/websites/mail/htdocs/roundcube

Create the MySQL database:

/usr/local/mysql/bin/mysql -u root -p
CREATE DATABASE roundcubemail /*!40101 CHARACTER SET utf8 COLLATE utf8_general_ci */;
GRANT ALL PRIVILEGES ON roundcubemail.* TO username@localhost IDENTIFIED BY 'password';

Adjust your PHP configuration (/usr/local/etc/php.ini) as necessary:

memory_limit = 64M;
display_errors = Off
log_errors = On
error_log = logs/errors.log
upload_max_filesize = 5M
post_max_size = 6M
zlib.output_compression = Off
suhosin.session.encrypt = Off
session.auto_start = Off
session.gc_maxlifetime = 21600
session.gc_divisor = 500
session.gc_probability = 1

Import the table layout:

cd /var/websites/mail/htdocs/roundcube
/usr/local/mysql/bin/mysql -u root -p roundcubemail < SQL/mysql.initial.sql

Point your web browser at

Set the username_domain to your default domain so that the user's Roundcube preferences will be the same whether they login with their full email address or just the username portion.

Once you've used the installer to create and, save them in /var/websites/mail/htdocs/roundcube/config
After completing the installation and the final tests please remove the whole installer folder from the document root of the webserver.

rm -rf /var/websites/mail/htdocs/roundcube/installer

To make sure that the SSL redirection from your Apache config file is applied to Roundcube, edit /var/websites/mail/htdocs/roundcube/.htaccess and edit the mod_rewrite section to include:

RewriteOptions inherit

Based on the upgrading instructions from

  • Backup the RoundCube directory:

    cd /var/websites/mail/htdocs
    cp -R roundcube /extra/roundcube.old
  • Backup the Roundcube MySQL database:
    /usr/local/mysql/bin/mysqldump -u username -p roundcubemail  | gzip -9 > /extra/roundcubemail.sql
  • Download the new version and decompress it:
    cd /extra/src
    tar zxf roundcubemail-0.9.5.tar.gz
    cd roundcubemail-0.9.5
  • Use the upgrade script to update your existing install:
    bin/ /var/websites/mail/htdocs/roundcube


Various bits of code, scripts, and procedures were put together with information from John Simpson's website. It's an excellent resource on managing and setting up a Qmail server.

Recent Updates

  • 11 months 3 weeks ago
  • 11 months 3 weeks ago
    Removed original versions of ucspi-tcp and ucspi-ssl and replaced them with upgraded versions. The old ones were failing PCI compliance tests by Security Metrics. ucspi-ssl also had issues installing on CentOS 7 - new version installed without issues.
  • 11 months 3 weeks ago
    1.3.7 update
  • 11 months 3 weeks ago
  • 1 year 1 hour ago