Installing Roundcube 0.3.1

Roundcube is an application that provides web-based access to IMAP email servers.

Prerequisites
Web server with php configured
PHP
Email server
RDBMS

Versions used
Apache 2.2.8
PHP 5.2.8
Hmailserver 5.3
MySQL 5.0.45

Steps

• Download the roundcube tar.gzip package from the roundcube website, roundcube.net
• Unzip the zip and tar to a temporary location e.g. C:\temp
• Create a new folder named roundcubemail in the webroot folder of the web server e.g. In c:\apache\htdocs
• copy the contents of c:\temp\roundcubemail-0.3.1 to c:\apache\htdocs\roundcubemail
• Open a command prompt window
• Type mysql -u root -p
• Enter the password for the mysql root user

mysql> create database roundcube;
mysql> grant all privileges on roundcube.* to roundcube@localhost identified by "roundcube";
> quit

• Using a browser, navigate to localhost/roundcubemail/installer/
• Click on the start installation button
• Click on the next button
• Disable spell checking, set details for the database and IMAP server
• Click on the create config button
• Create a new file named main.inc.php in c:\apache\htdocs\roundcubemail\config and paste the contents of the main.inc.php section to it
• Edit this file, main.inc.php, setting the smtp authentication details [for servers that require smtp authentication].

// SMTP username (if required) if you use %u as the username RoundCube
// will use the current username for login
$rcmail_config['smtp_user'] = 'valid user account';

// SMTP password (if required) if you use %p as the password RoundCube
// will use the current user's password for login
$rcmail_config['smtp_pass'] = 'valid password';

// SMTP AUTH type (DIGEST-MD5, CRAM-MD5, LOGIN, PLAIN or empty to use
// best server supported one)
$rcmail_config['smtp_auth_type'] = 'LOGIN';

• Create a new file named db.inc.php in c:\apache\htdocs\roundcubemail\config and paste the contents of the db.inc.php section to it
• Click on the continue button
• Click on the initialize database button
• Fill in appropriate details for testing smtp settings and click on the send test mail button
• Fill in appropriate details for testing the imap configuration and click on the check login button
• Open a new browser window and navigate to localhost/roundcubemail
• Log in with details of a valid email account