Best practice to change from WAR to Bin installation

Platform Notice: Data Center Only - This article only applies to Atlassian products 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

We will suggest to perform the following steps (for the migration in same server):

  1. Backup the JIRA Home Directory (include plugins, attachments, and data).

  2. Backup the Data:

    1. Export an XML backup via the JIRA Backup UI.

    2. Backup the database.

  3. Shutdown JIRA WAR.

  4. Install a new JIRA Bin on your server.

  5. Run the JIRA Configuration Tool.

  6. Configure JIRA to use the backup JIRA Home Directory.

  7. Configure JIRA to use the current database.

  8. Start JIRA.

If you plan to do the migration on another server, please refer to our Migrating JIRA to Another Server article.

ℹ️ We recommend to test these changes in a Staging Environment.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.