## page was renamed from VladimirKrstulja/PortsTipsTricksAndGotchas/Roundcube
= 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'''.