RoundCube is a brilliant web-based email offering, we run it under Apache or Lighttpd.

Requirements

emerge -av dev-php/PEAR-PEAR dev-php/PEAR-Net_IDNA2

Be sure to configure your PHP error reporting, date_timezone

Installing RoundCube

We'll put RoundCube into a dedicated host and path, like mail.example.com/rc 

git clone git://github.com/roundcube/roundcubemail.git /opt/roundcube

Configure Database

Copy the distributed db & main configuration files to local configs. Then update them as necessary. 

cp ./config/db.inc.php.dist ./config/db.inc.php
nano ./config/db.inc.php

cp ./config/main.inc.php.dist ./config/main.inc.php
$rcmail_config['enable_installer'] = true;

Create MySql Stuff 

create user 'roundcube'@'localhost' identified by 'roudncube';
create database roundcube;
grant all on roundcube.* to 'roundcube'@'localhost';

Under Apache

There is very little to do here, RoundCube is designed to operate out of the box on Apache. Simply create a virtualhost to point to this webroot.

Under Lighttpd

There are a few PHP configuration variables that need to be set for this operation. As well, some handling from the .htaccess file nees to be re-created with Lighttpd. 

chown -R lighttpd:lighttpd ./logs ./temp

$HTTP["host"] != "mail.example.com" {
	server.document-root  = "/var/www/mail.example.com/webroot"
	alias.url = (
		"/rc" => "/opt/roundcube"
	)
}

See Also