====== Roundcube ======

Roundcube is a webmail client written in PHP.

  * [[http://www.freshports.org/mail/roundcube|Roundcube]] at Freshports

===== First Installation =====

The first installation of Roundcube requires creation of the database and a database user. Please read the [[https://github.com/roundcube/roundcubemail/blob/master/INSTALL|INSTALL]] file for detailed instructions. The file is also available in the Roundcube installation directory, ''%%/usr/local/www/roundcube%%''.

===== Upgrading an Existing Installation =====

After an existing Roundcube installation is upgraded, a manual step is required to ensure the config files and the DB schema are up to date and in line with the new version. Please read the [[https://github.com/roundcube/roundcubemail/blob/master/UPGRADING|UPGRADING]] file for detailed instructions. The file is also available in the Roundcube installation directory, ''%%/usr/local/www/roundcube%%''.

===== Migration Tips =====

The Roundcube database stores user profiles associated with IMAP server address **value**. Changing that **value**, even to change between an IP address and hostname (or vice versa), will require updating the ''%%mail_host%%'' column of the ''%%users%%'' table, if the user profiles for that server which only changed the address are to be retained. Please consult the comments for ''%%default_host%%'' entry of ''%%/usr/local/www/roundcube/config/defaults.inc.php%%'' especially **if you use replacement variables**.