How to roll back or restore a previous version of Confluence Data Center
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
On this page:
Summary
When something goes wrong with a Confluence upgrade, you may need to roll back your instance to a pre-upgrade state from backups.
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 the Confluence home directory, installation directory, and database from 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
- Install a new clean Confluence of the version that needs to be restored
- Restore the database backup. 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>- Copy the attachments folder from the upgraded <ConfluenceHome> to the new <ConfluenceHome>
- Start Confluence
- Rebuild the search index