Splitting a JIRA instance

Occasionally an organisation may need to split its existing JIRA instance into two separate instances. For example, there might be a requirement to have some particular projects in one JIRA instance, and other projects in a second instance.


This process requires two separate server licenses.

To split a JIRA instance:

  1. Back up your database, using your database backup procedures, and verify the backup.
  2. Back up your attachments directory and verify the backup.
  3. Install JIRA on your new server.
    (warning) Please Note:
    • The JIRA version number on your new server must be the same as (or higher than) the version number on your existing server.
    • Do not use the same JIRA Home Directory for the two JIRA instances. Specify a new JIRA home directory for the JIRA on your new server.
    • Do not connect the two JIRA instances to the same external database instance.
  4. Create an XML backup from your existing JIRA server, as described in Backing up data.
  5. Import the XML backup file into your new server, as described in Restoring data.
  6. Copy the attachments directory from your existing server to your new server, and configure your new server to use its own directory (for details please see Enabling File Attachments).
  7. At this point you should have two JIRA instances with the same users, projects, issues and attachments. Log in to both instances and perform some random searches to verify that the data is identical in both instances.
  8. Delete the non-required projects from each JIRA instance.
  9. Generate new Server ID for the newly installed JIRA instance as described in the article Changing Server ID. This step is needed if you plan to create Application Links between the JIRA instances.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport