Documentation for JIRA 5.1.x. Documentation for other versions of JIRA is available too.

The 'roll back' procedures on this page describe how to restore your previous version of JIRA in the unlikely event that you encounter an issue with your JIRA upgrade. Please follow the procedure below that relates to the upgrade procedure you used.

(info) If you upgraded JIRA using the Migrating JIRA to Another Server procedure, your previous JIRA installation should still be 'intact' (assuming you haven't deleted it) and there should not be a need to perform any 'roll back'.

Rolling Back a JIRA Upgrade Conducted Using the Upgrade Wizard

Use this procedure to roll back a JIRA upgrade conducted using the upgrade wizard.

(info) Prior to rolling back your JIRA upgrade, ensure that you have the following backups from your previous JIRA version:

  • The JIRA database (generated by your database's own backup tools).
  • The JIRA Home Directory.
  • The JIRA Installation Directory.

To roll back your JIRA upgrade conducted using the upgrade wizard:

  1. Stop the JIRA upgrade or the upgraded JIRA server if it is running.
  2. Use your database server's tools to restore the JIRA database backup you had created.
  3. Delete the contents of the JIRA Installation Directory.
  4. Restore the backed-up JIRA Installation Directory to the same location in the previous step.
  5. Delete the contents of the JIRA Home Directory.
  6. Restore the backed-up JIRA Home Directory to the same location in the previous step.
  7. Start JIRA (by running the start-jira.sh or start-jira.bat file in the bin subdirectory of your restored JIRA installation directory).

Rolling Back a JIRA Upgrade Conducted Manually

Use this procedure to roll back a JIRA upgrade conducted using the manual JIRA upgrade procedure (involving an 'in-place' database upgrade). The intended result of this procedure is to restore your previous JIRA installation to its original state (consisting of the restored database as well as the JIRA Installation and Home directories in their original locations).

(info) Prior to rolling back your JIRA upgrade, ensure that you have the following backups from your previous JIRA version:

  • The JIRA database (generated by your database's own backup tools).
  • The JIRA Home Directory.
  • The JIRA Installation Directory.

To roll back your JIRA upgrade conducted manually with an 'in-place' database upgrade:

  1. Stop the JIRA upgrade or the upgraded JIRA server if it is running.
  2. Use your database server's tools to restore the JIRA database backup you had created.
  3. If you had deleted the JIRA Installation Directory of your previous JIRA version, restore the backed-up JIRA Installation Directory to its original location.
  4. Delete the contents of the JIRA Home Directory.
  5. Restore the backed-up JIRA Home Directory to the same location in the previous step.
  6. Start JIRA (by running the start-jira.sh or start-jira.bat file in the bin subdirectory of your restored JIRA installation directory).
  • No labels



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.