Roundcube is a browser-based IMAP client with an easy-to-use user interface. It provides full functionality you expect from an email client, including MIME support, address book, folder manipulation, message searching and spell checking.


For this guide you should be familiar with the basic concepts of


Roundcube is released under the GNU General Public License version 3 or any later version with exceptions for skins and plugins.


We’re using PHP in the stable version 8.2:

[isabell@stardust ~]$ uberspace tools version use php 8.2
Selected PHP version 8.2
The new configuration is adapted immediately. Patch updates will be applied automatically.
[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '8.2'
[isabell@stardust ~]$

If you want to use your Roundcube with your own domain you need to setup your domain first:

[isabell@stardust ~]$ uberspace web domain list
[isabell@stardust ~]$

You’ll need your MySQL credentials. Get them with my_print_defaults:

[isabell@stardust ~]$ my_print_defaults client
[isabell@stardust ~]$


cd to your document root, download the latest release of Roundcube, extract it and remove the archive afterwards.


Check the Roundcube website or Github Repository for the latest stable release and copy the download link to the Complete.tar.gz file. Then use wget to download it. Replace the URL with the one you just got from GitHub/Website.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/html/
[isabell@stardust html]$ wget
[isabell@stardust html]$ tar xf roundcubemail-*.tar.gz --strip-components=1
[isabell@stardust html]$ rm -r roundcubemail-*.tar.gz
[isabell@stardust html]$


Create Database

Roundcube saves your data in a MySQL database. It is recommended to use an additional database (e.g. isabell_roundcube) instead of the default database.


You need to create the database before you enter the database credentials in the Roundcube Installer.

[isabell@stardust ~]$ mysql -e "CREATE  DATABASE ${USER}_roundcube"
[isabell@stardust ~]$

Roundcube Installer

The final configuration can easily be done in the browser. Point your Browser to your installation URL

All prerequisite checks should be OK - click NEXT.


You can safely ignore the NOT AVAILABLE-Warnings at the SQLite, SQL Server etc Databases, as we’ll use the MySQL Database.

Enter the following details at the Tab CREATE CONFIG:

General configuration

  • Product name (choose whatever you want, e.g. isabell Roundcube)

  • Activate the option ip_check for greater security. It checks the client’s IP in session authorization.

Database setup

  • Database type (use mySQL)

  • Database server (use localhost)

  • Database name (e.g. isabell_roundcube)

  • MySQL username (equals your Uberspace username, e.g. isabell)

  • MySQL password - you should know your MySQL credentials by now. If you don’t, start reading again at the top.

  • db_prefix (e.g. rc_)

IMAP & SMTP Settings

  • default_host (use ssl://„server“, e.g. ssl://

  • default_port (use 993)

  • username_domain - This is a convenience option for email providers that use a full email address as the username. This field is optional. Entering a domain — not the full email — will allow you to login to Roundcube with just your name, before the @, instead of the whole email. For example, domain.tld in the field will allow user@domain.tld to log into Roundcube with user.

This, however, doesn’t restrict access if somebody enters the full email address. If you want to restrict the users access to Roundcube to a specific domain have a look at Restrict Access in the Secuity-Section.

  • Make sure the auto_create_user check box is checked. If it’s unchecked, Roundcube won’t create a user in its own database, which will prevent you from logging in.

  • smtp_server (use tls://„server“, e.g. tls://

  • smtp_port (use 587)

  • junk_mbox (use Spam)


Make sure to add the prefixes (ssl:// / tls://) as mentioned above, otherwise you won’t be able to receive or sent mails. Uberspace does not support insecure access.


We’ll adjust the default setting Junk to Spam to refer to the default default Spamfolder.

Activate the option Use the current IMAP username and password for SMTP authentication.

Display settings & user prefs

  • Enter your desired language for RoundCube under language. The code for German is de_DE, English is en_US, the code for French is fr_FR etc


Users can set their own language.


If you want to add Plugins to your configuration check the corresponding checkboxes.

When you’re done click CONTINUE. The configuration file will be created and stored in /var/www/virtual/$USER/html/config.

Finishing installation

On the last tab Test config click on initialize database to initialize the database.


Optionally you can check your SMTP & IMAP config by entering valid credentials down here, but it’s not necessary.

You’re done. Point your Browser to your installation URL and admire your shiny new Roundcube!

Best practices


Remove Installer-Directory


For security reasons, you should remove the installer-directory from the source files.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/html
[isabell@stardust html]$ rm -r installer/
[isabell@stardust html]$

Restrict Access

Add the following to your ~/html/config/

$rcmail_config['username_domain'] = 'domain.tld';
$rcmail_config['username_domain_forced'] = true;

All domains in the logins will be replaced by the specified domain above. If you want to specify multiple domains you’ll have to create an array like the following:

$rcmail_config['username_domain'] = array(
  'mail.domain.tld' => 'domain.tld',
  'othermail.domain2.tld' => 'domain2.tld',

Login Pattern

Use your full email address and the corresponding password to login. This works with your address as well as with any addresses using your own domains.



Check the update feed regularly to stay informed about the newest version.

If there is a new version available, always make a backup first including your Roundcube directory and your database.

On the command line

Get the latest version

cd to your home directory (e.g. /home/isabell), download the latest release of Roundcube and extract it.


Make sure to download and extract the tarball to a different location as your active roundcube installation to prevent an accidental override!


Check the Roundcube website or Github Repository for the latest stable release and copy the download link to the Complete.tar.gz file. Then use wget to download it. Replace the URL with the one you just got from GitHub/Website.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/
[isabell@stardust isabell]$ wget
[isabell@stardust isabell]$ tar xf roundcubemail-*.tar.gz
[isabell@stardust isabell]$

Read the UPGRADING and INSTALL files and check system requirements of the new version before continuing.

Update your existing Roundcube installation

cd to the downloaded and extracted roundcube directory and execute the bundled with Roundcube to easily update your installation. The script first copies all updated files to the target directory and then runs the update script that will update/migrate your local configuration files and update the database schema if necessary.


Make sure to change the directory followed by the script-call to your active roundcube directory bin/ **<your-existing-roundcube-directory>**. The Output of the Updatescript can vary depending of your your version and which files have been changed.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/roundcubemail-1.6.5/
[isabell@stardust roundcubemail-1.6.5]$ bin/ /var/www/virtual/$USER/html
? Upgrading from 1.4.2. Do you want to continue? (y/N)
✔ Copying files to target location..../
ℹ NOTICE: JavaScript dependencies installation skipped.
✔ Running update script at target...
✔ Executing database schema update.
ℹ NOTICE: Update dependencies by running `php composer.phar update --no-dev`
✔ This instance of Roundcube is up-to-date.
✔ Have fun!
✔ All done.
[isabell@stardust roundcubemail-1.6.5]$

Finishing updating

Remove the temporary folder as well as the archive after finishing the update process.

[isabell@stardust roundcubemail-1.6.5 ]$ cd /var/www/virtual/$USER/
[isabell@stardust ]$ rm -r roundcubemail-*
[isabell@stardust ]$

Via FTP + Installer


If you prefer to upgrade manually via FTP and the Installer (like described above) refer to the Upgrade Manual of the official Roundcube Wiki for further instructions.

Tested with Roundcube 1.6.5, Uberspace 7.15.6

Written by: Achim | pxlfrk <>