How to roll back to a previous version of Confluence
On this page:
Overview
When something goes wrong with the upgrade, or some important plugins are not compatible with the current version of Confluence you may need to roll back your instance to a pre-upgrade state.
Reinstalling Confluence and Restoring the Database Backup
Atlassian doesn't provide a tool for downgrading or rolling back to a previous version of Confluence. Once the upgrade is done, it can't be undone.
Be sure to have a backup of your Confluence before the upgrade was performed .
Rolling Back From Backups
- Stop Confluence;
- Restore your Database from backup with the original name of Confluence’s database from before the upgrade;
- Restore your Home directory from backup with the original name and original location from before the upgrade;
- Restore your Installation directory from backup with the original name and on the original location from before the upgrade;
- Start Confluence.
Restoring From a Fresh Confluence Install
Attachments stored in the database:
The steps to follow in case you have attachments stored in the database:
- Install a new clean Confluence of the version that needs to be restored.
- Restore the database backup. Is important to mention that this backup needs to be from before the upgrade.
Edit the following line in the confluence.cfg.xml file located under <ConfluenceHome> to point to the proper database schema:
<property name="hibernate.connection.password">DATABASEPASSWORD</property> <property name="hibernate.connection.url">jdbc:mysql://localhost/DATABASE_SCHEMA?sessionVariables=storage_engine%3DInnoDB</property> <property name="hibernate.connection.username">DATABASEUSERNAME</property>
- Start Confluence.
- Rebuild the search index.
Attachments stored in the filesystem:
Same steps above, but after step 3 you just need to copy the attachments folder from the upgraded <ConfluenceHome> to the new <ConfluenceHome>.