Documentation for JIRA 4.0. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

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 requires two separate server licenses.

To split a JIRA instance,

  1. Backup your database, using your database backup procedures, and verify the backup.
  2. Backup your attachments directory and verify the backup.
  3. Install JIRA on your new server. 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 file from your existing JIRA server, as described in Backing up data.
  5. Import the XML 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 into 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.