Skip to content

Roundcube App

About

Roundcube webmail is a browser-based multilingual IMAP client with an application-like user interface.

Default Setup

Roundcube is pre-configured for use with Cloudron Email.

Multi-domain Setup

Users can login with their email and password to access their mailbox. If the Cloudron has two domains, example1.com and example2.com, the user can login using user@example1.com and user@example2.com. Aliases can be added as identities under Roundcube settings.

External domains

The roundcube app does not support adding domains that are not managed in Cloudron. Consider using Rainloop app as an alternative.

Vacation Email

An out of office / vacation mail message can be setup using Sieve filters.

A vacation message can be set in Settings -> Filters -> Add filter -> Vacation message action.

Forwarding all emails

To forward all emails to an external mail, setup a Sieve filter in Settings -> Filters -> Add a filter -> Forward to

Plugins

Plugins can be installed as follows:

  • Extract the plugin using the File Manager into /app/data/plugins.

  • Change the ownership of the extracted plugin to www-data.

  • Add the plugin to $config['plugins'] in /app/data/customconfig.php:

    array_push($config['plugins'], 'myplugin');
  • Some plugins have dependencies that need to be installed via composer. composer requires a lot of RAM for it's resolution mechanism. For this reason, first bump the memory limit of the app to 2GB and then run composer using the Web Terminal. You can reset back the memory limit after installation is complete.
    # cd /app/data/plugins/<plugin>
    # composer install --no-dev --optimize
    # chown -R www-data:www-data .

Enabling PGP support

The Enigma plugin can be used to enable PGP support. The Enigma plugin is part of the roundcube code and no installation is required. To enable the plugin:

  • Add the following lines to /app/data/customconfig.php:
    array_push($config['plugins'], 'enigma');
    $config['enigma_pgp_homedir'] = '/app/data/enigma';
  • Create the directory where enigma will save the PGP keys on the server:
    mkdir /app/data/enigma
    chown www-data:www-data /app/data/enigma
  • New PGP keys can be created or existing ones can be imported in Settings -> PGP Keys

  • When composing new mail, you will see an Encryption icon in the tool bar.

Changing the title

Add the following lines to /app/data/customconfig.php using the File Manager:

$rcmail_config['product_name'] = 'My Hosting Company';

Skins

Skins can be installed as follows:

  • Extract the skin using the File Manager into /app/data/skins.

  • Change the ownership of the extracted skin to www-data.

  • Set the new skin as the default skin by adding this line in /app/data/customconfig.php:

    $rcmail_config['skin'] = 'newskin_directory_name';

To customize CSS and logo, it's best to create a copy of an existing skin and make changes as needed.

# cd /app/data/skins
# cp -Lr larry customskin
... make changes in customskin ...
# chown -R www-data:www-data customskin
  • Set the new skin as the default skin by adding this line in /app/data/customconfig.php:
$rcmail_config['skin'] = 'customskin';

By default, the search field only searches the current folder. To search across all folders, change the Scope.