RoundCube — Change Skin for domain Branding

If you haven't already...
Set up an Affiliate Account or Set up a Small Business account.
Posted on November 13, 2017 by admin under RoundCube
Leave a comment

RoundCube provides a robust web interface for managing mail. I want one of my domains to use a different logon screen and log, however, I want all the other domains to maintain the default.

The first think we need to do is to start from the default theme provided with roundcube.

  1. Change directory to the roundcube skins directory
    • cd /usr/share/roundcubemail/skins/
  2. Copy the larry skin to the
    • cp -ar ./larry ./

We now have a new skin that we can use/modify for our domain “”, we just need to tell roundcube to do so. For that, we will use the include_host_config option. If you don’t know about RoundCube Branding and the include_host_config option, see the RoundCube — Enable for Branding article for more information.

After adding the domain to the roundcube configuration file, edit the domain specific options file and add the following lines.

$config['username_domain'] = '';
$config['skin'] = '';
$config['skin_logo'] = array("*" => "skins/");
$config['product_name'] = 'Domain's Mail Services';


From the above, we have four items we want to customize.

  1. username_domain, will add the supplied value as the domain if omitted by the user.
  2. skin, specifies the name of the directory containing the themes web interface files
  3. skin_logo, The path to the log to use for the interface theme.
  4. product_name, the tagline for the product information

The username_domain option if very nice, it allows email accounts for that domain to NOT have to enter the entire address when logging in. For example, with this option enabled, users at the interface could simply enter emailuser rather than the more traditional

The skin parameter points to the folder we copied earlier and product_name is freeform text displayed under the logon screen…and maybe elsewhere, not sure.

That leaves us with one item left in our skin branding, the skin_logo. For this simply create the new image and upload to the /usr/share/roundcubemail/skins/


Leave a Reply

Please Login to comment
Notify of