Introduction

You've had RoundCube up and running for a while, and now there is a shiny new version out and you need to upgrade. Where to start?

Download an Updated Version

As with installation, you need to download the files for the newest version. The easiest way to get it is to visit http://www.roundcube.net and click on "Downloads" or just go to http://www.roundcube.net/?p=downloads. Wait for it to download, and then unzip (using WinZip or "tar xvfz roundcubemail-0.1beta.tar.gz") in the current directory.

Backup, Backup, Backup!

I can't stress this enough: Back everything up!

First, make a copy of your RoundCube directory. This will help in case the new version does not work for you, you can always go back. If you are feeling daring, you can backup only your configuration files config/main.inc.php and config/db.inc.php

Next, perform a database dump and save the file in a safe place. If the new version of RoundCube requires any changes to the database schema, you may need to restore this backup if you have to revert to the earlier version.

Check Your Configuration

Download your config/main.inc.php and config/db.inc.php files and place them in your config folder so you will not have to copy them over later.

Be sure to check config/main.inc.php.dist and config/db.inc.php.dist to make sure you have any new settings that may have appeared in the new version! Some people may prefer to copy the new .dist files and recreate their needed changes.

Upload a new copy

Use your favorite FTP/SFTP/SCP program to rename or remove the old folder and upload the new one.

Database Setup

While you're uploading (or after you're done) you have one final step to do before you can start using your new version of RoundCube. You need to check to see if any database changes are needed. Look in the SQL directory in RoundCube, and find a file that is named: "*.update.sql" where * is your database backend type (MySQL, MySQL 5, PostgreSQL, SQLite). You only need to execute the commands listed that happened after the version you had previously installed (i.e. anything listed as "Updates from 0.1-beta2").

If desired, you could also drop all of the tables and use the *.initial.sql file to fully recreate the database.

Conclusion

That should be all that is needed to upgrade. If you have problems, you can always restore the backups and try again, or ask for help on the forums. If you need help, be sure to take note of any errors that appear on your screen or in the log files.

Enjoy!