====== 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 -p --add-drop-table --allow-keywords > mybackup.sql ===== Basic Instructions ====== * 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 ===== Migrating from Ampache 3.3.x --> 3.4 ===== 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. ===== Migrating from Ampache 3.3.x --> 3.3.3.5 ===== 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 ===== Migrating from Ampache Pre 3.3 --> 3.3.x ===== Updates from pre 3.3 versions of Ampache are no longer supported in the latest releases. It is recommended that you first download [[http://ampache.org/downloads/ampache-3.3.5.tar.gz|Ampache 3.3.5]] and run any update process for that version before continuing to the newest release.