How to roll back or restore a previous version of Confluence Data Center
Platform Notice: Data Center Only - This article only applies to Atlassian apps on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. 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
Summary
On this page:
When a Confluence upgrade goes wrong, you may need to roll back your instance to a pre-upgrade state from backups.
Solution
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 frombefore 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 Shared Home directory from backup with the original name and on the original location from before the upgrade. This step is critical if you are upgrading from a version lower than Confluence v8.1, as the upgrade will trigger the attachments migrations to v4.
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.
Was this helpful?