Roundcube Update

21. July 2014

Introduction

Roundcube is a popular web-based email client software that provides a modern and intuitive user interface. To benefit from the latest features, security updates and improvements, it is important to update your Roundcube installation regularly. This guide will guide you step by step through the update process and help you avoid possible errors.

Note: This guide is without guarantee. Make sure that you make a full backup before the update to avoid data loss.

Backup, backup, backup!

It is essential to perform a complete backup before the update.

Secure the Roundcube directory (by default) /var/www):

cd /var/www
cp -r roundcube roundcube_org

Also create a backup of the database:

mysqldump -u <USER> -p<PASSWORT> <DATENBANK> > roundcube_dmp.sql

Download Roundcube

Download the latest version of Roundcube down and save it on your server.

cd <where-the-tarball-is-saved>
tar xf roundcubemail-*.tar.gz

Update of the existing Roundcube installation

The easiest way is to use the installto.sh– Scripts:

cd <the-unpacked-roundcube-directory>
bin/installto.sh <your-existing-roundcube-directory>

Follow the instructions on the shell. The script copies updated files and updates the configuration and database schema.

Alternatively, you can do the update manually. Read the section “Manual Update” in the UPGRADE-File of the release.

Update via FTP + Installer

Unpack the file and upload the required files with an FTP/SFTP/SCP client:

./bin/*
./SQL/*
./program/*
./installer/*

Load plugins/* and skins/* from the release, without overwriting the existing skins and plugins folders.

Copy configuration files

config/defaults.inc.php
config/mimetypes.php

Start Installer

Activate the installer in your configuration file (config/config.inc.php or config/main.inc.php for versions <1.0):

'enable_installer' => true

Then open in the browser:

http://<url-to-roundcube>/installer/

Follow the instructions to configure and update the database schema.

Final steps

After a successful update, deactivate the installer:

'enable_installer' => false

To protect your installation, you should: installer/-Remove directory completely from the server.