How to roll back to a previous version of Confluence

Still need help?

The Atlassian Community is here for you.

Ask the community

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

tip/resting Created with Sketch.

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.

tip/resting Created with Sketch.

Be sure to have a backup of your Confluence  before the upgrade was performed .

Rolling Back From Backups

  1. Stop Confluence;
  2. Restore your Database from backup with the original name of Confluence’s database from before the upgrade;
  3. Restore your Home directory from backup with the original name and original location from before the upgrade;
  4. Restore your Installation directory from backup with the original name and on the original location from before the upgrade;
  5. 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:

  1. Install a new clean Confluence of the version that needs to be restored.
  2. Restore the database backup. Is important to mention that this backup needs to be from before the upgrade.
  3. 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>
  4. Start Confluence.
  5. 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>.

Last modified on Mar 21, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.