Round Cube

This document describes the installation of RoundCube (RC) webmail on a GNU/Linux server from the subversion sources. Packages for specific distributions are available from the RoundCube site.

About RoundCube

RoundCube is a rather advanced webmail client that has an "application like" interface. This means it uses AJAX and other JavaScript/DHTML technologies to provide a rich user experience. A demo is hosted by RoundCube.net.

Requirements

Apache 2.0
PHP4 or PHP5 with database support
MySQL, PostgreSQL or SQLite
Subversion client
IMAP and SMTP servers

The sample system in this document is running Linux 2.6.12, Apache 2.0.58, PHP 5.1.6 and PostgreSQL 8.0.8.

Installation

All these commands are run as root; be careful. The installation will be at the root of a website. Modify the Apache configuration to change this. The sample config shows how.

Create a new webroot to contain RC and change to that directory:

mkdir -p /var/www/webmail
cd /var/www/webmail

Use subversion to checkout or export the latest sources. Subversion is available over SSL, you will need to accept their self-issued certificate.

svn ls https://svn.roundcube.net/trunk/
svn checkout https://svn.roundcube.net/trunk/roundcubemail/ ./
# or this:
svn export --force https://svn.roundcube.net/trunk/roundcubemail/ ./

Update ownership of the temp and logs directory for RC so that Apache can read and write to them:

chown -R www:www temp logs
chown -R root:root SQL config program skins

Create the necessary PostgreSQL database structures:

psql -U postgres -c 'create user roundcube'
psql -U postgres -c 'create database roundcube with owner roundcube'
psql -U roundcube -f SQL/postgres.initial.sql
psql -U postgres -c "alter user roundcube with password '$somepass'"

If an upgrade is being performed then it is necessary to run the SQL updates.

psql -U roundcube -f SQL/postgres.update.sql

Configuration

Update the RC and Apache configurations accordingly.

Configure RC for the database DSN, connection types, caching, IMAP and SMTP hosts.

config/db.inc.php

config/main.inc.php

ChangeLog

27 Nov 2006 - Created /djb

« Base Configuration «