Upgrading your Ampache Installation

Every attempt is made to make upgrading your Ampache installation as painless as possible. Although we do everything we can to prevent data loss during an upgrade it is never a bad idea to backup your database before performing an upgrade. Below is a simple command line way to backup your MySQL database

mysqldump -u <USERNAME> -p <AMPACHEDB> --add-drop-table --allow-keywords > mybackup.sql

• Move your Old Install Directory out of the way

mv ampache ampache.old

• Extract the new version

tar -xzf current.tar.gz

• Copy your config file from the old install to the new directory

cp ampache.old/config/ampache.cfg.php ampache/config/

• Attempt to login as normal, Ampache will prompt you for any database upgrades which must be performed

Ampache 3.4 Introduces a new config format. Still follow the basic instructions however when attempting to login Ampache will redirect you to a different update page telling you that your ampache.cfg.php is out of date and must be updated. Run the command line script as instructed before continuing.

The newest release of Ampache will prompt Admins to download and install a config file if their current one is out of date. While ampache may work without the new config file, results may vary it is strongly recommended that if prompted you install the newly created config file

Updates from pre 3.3 versions of Ampache are no longer supported in the latest releases. It is recommended that you first download Ampache 3.3.5 and run any update process for that version before continuing to the newest release.