Roundcube is the default webmail software as of Plesk 11.5.22 released on 02-Apr-2013.

If you are running Plesk 11.5.22 or greater you do not need to continue with these instructions. Please consult the Plesk documentation.

If you prefer to update your Roundcube immediately after a new release or have a need to tweak files in the Roundcube installation (plugins, skins, etc) then you can install your own custom Roundcube with these instructions.

 

I'm sure there are numerous ways to install Roundcube webmail on a server running Plesk 11 with Red Hat/CentOS 6.x but here is how I did it.  The key focus of my approach is to take advantage of the Plesk infrastructure as much as possible and minimize any custom changes outside of Plesk.

Some of the advantages of this approach are:

  • By staying within the Plesk environment you take advantage of Plesk's management of the environment (Apache, PHP, FastCGI, etc) while avoiding any unintended conflicts with Plesk.  I've used Plesk for quite a few years and although it's more forgiving than it used to be I still find that configuration changes made outside of Plesk can cause problems, especially during updates/upgrades.
  • You can use the Plesk Backup Manager to backup the Roundcube installation and restore to multiple servers making it much easier to set up Roundcube on a new server.
  • The same approach can be used for Windows and Linux servers.

This procedure should work for versions of Roundcube prior to 0.8.x, Plesk 10 and Red Hat/Centos 5.x but I haven't tested it.  It should also work for Windows servers if you start at Step 2 (again, I haven't tested it).

 

  1. First you'll need to set up the Extra Packages for Enterprise Linux (EPEL) repository on your server to resolve some of the library dependencies needed by Roundcube. Follow the instructions in this article before continuing.

    EPEL has a Roundcube package but I don't use it because it is not always updated in a timely manner, at least not as timely as I prefer.  However, I do use it to resolve the Roundcube dependencies with the following commands:

    yum install roundcubemail
    yum remove roundcubemail

    The first command installs Roundcube and all it's dependencies and the second command removes the outdated Roundcube leaving the dependencies installed.

     

  2. Login to the Plesk control panel and create a new subscription with the following values:

    AddSubscription


  3. Open the control panel for roundcube.local and create a database and database user with the following values:

    Database name: roundcube_local
    User name: roundcube_local


  4. Go to the "Website & Domains" tab in Plesk and create a domain alias for one of your existing domains such as webmail.yourdomain.com to roundcube.local.

    Note that if you have either Horde or Atmail installed (even if it is disabled) then Plesk will reserve the webmail.* subdomain for itself in all domains.  You can either use a different alias such as roundcube.yourdomain.com or go to Tools & Settings-->Webmail in the Plesk control panel and remove all installed webmail products.  The rest of the article will continue to use the webmail.yourdomain.com alias, just make the appropriate adjustments as you go along.

    AddDomainAlias1

    AddDomainAlias2

    If you do not have a wildcard DNS entry then you will have to create an A record for the webmail.yourdomain.com alias you just created.

     

  5. Upload and extract the latest Roundcube into the httpdocs directory.  In your browser, go to webmail.yourdomain.com/installer/ and follow the install wizard to complete the Roundcube installation.  Refer to the Roundcube Wiki and user support forums for assistance.

 

 

Now that you have a working Roundcube installation you have three options to set up Roundcube for the other domains on your server.

 

OPTION 1 (good):

Have all the mail users on your server use the webmail.yourdomain.com URL.

If you want to force access over HTTPS then save the htaccess file attached to this article, upload to the httpdocs directory of roundcube.local and rename to .htaccess.

 

OPTION 2 (better):

Set up additional webmail.* domain aliases to roundcube.local for each domain that you want to use Roundcube with.  For any domains that do not have a wildcard entry in their DNS you will need to create a webmail A type record.

If you want to force access over HTTPS then save the htaccess file attached to this article, upload to the httpdocs directory of roundcube.local and rename to .htaccess.

This setup is appropriate for servers that have very few domains, do not add new domains often or have a mixture of domains using Roundcube, Horde and/or Atmail. 

 

OPTION 3 (best):

Save the vhost.conf and vhost_ssl.conf files attached to this article and upload to the conf directory of roundcube.local. If you want to force access over HTTPS then uncomment lines 4-6 in vhost.conf.  Then execute the following command as root to have Plesk pick up the new vhost files:

/usr/local/psa/admin/bin/httpdmng --reconfigure-domain roundcube.local

For any domains that do not have a wildcard entry in their DNS you will need to create a webmail A type record.

Finally, remove the webmail.yourdomain.com alias that you created in step 4.

This setup is appropriate for servers that have numerous domains, regularly add/remove domains or intend to use Roundcube exclusively (i.e Horde and Atmail are not installed or are disabled).

 

 

 

vhost.conf
vhost.conf
vhost_ssl.conf
vhost_ssl.conf
htaccess
htaccess