Migrating from JIRA Cloud to Server applications

This page is for people who are currently using a JIRA Cloud application site and wish to move to a JIRA application instance that is hosted on their own servers. If you want to move a project, not your entire site, then see Restoring a project from backup (note, the instructions on that page take into account the version mismatch between JIRA Server and Cloud applications).

On this page:

Summary

You will need to download and install the latest production release of JIRA Server applications. Please check the JIRA application download page for the latest version. Once you have installed the latest production version, you then move your data from your hosted JIRA Cloud application site into your new JIRA Server application instance.

For all of the following procedures, you must be logged in as a user with the JIRA Administrators global permission.

Before you begin

JIRA Cloud applications are regularly updated with the absolute latest features and improvements — they are essentially running on a later version than the latest downloadable version of JIRA applications. If you want to migrate from JIRA Cloud applications to JIRA Server applications, please be aware of the following information before you begin:

Known issues

Read the following known issues before you start your migration:

  • Tempo data loss: If you have made changes to the Tempo scheduler in JIRA Cloud applications after March 24 (JIRA 6.3-OD-01 upgrade), these changes will be lost when you migrate to JIRA Server applications. This is due to changes that we have made to the scheduler data in JIRA Cloud applications that are not available in JIRA 6.2.x. To address this issue, choose one of the following options:
    • Do not make changes to the Tempo scheduler in JIRA Cloud applications after March 24. Wait until you have migrated to JIRA Server applications before making changes.
    • Keep a record of any changes that you make to the Tempo scheduler in JIRA Cloud applications after March 24 and make those same changes in Tempo after you migrate to JIRA Server applications.
    • (Not for production sites) Migrate to a JIRA 6.3 EAP instance.

Feature loss

If you migrate from JIRA Cloud to Server applications, you will likely find a few features missing. This is because we have introduced features from the upcoming JIRA Server application version into JIRA Cloud applications. For example, the latest JIRA Server application release is JIRA 6.2.x. JIRA 6.3 is currently under development. Some of the JIRA 6.3 features have been made available in JIRA Cloud applications, but will not become available for JIRA Server applications until the final JIRA 6.3 version is released.

JIRA application licenses

Your Atlassian Cloud license cannot be used in an instance installed from JIRA Server applications. You will need to generate a new JIRA Server application license from https://my.atlassian.com.

You can reuse your licenses for plugins in your instance installed from JIRA Server applications. The licenses for Atlassian plugins and Gliffy for JIRA applications can be viewed on https://my.atlassian.com. You will need to contact your vendor for the licenses for all other third-party plugins.

Migrating other Cloud applications

The instructions on this page only apply to JIRA applications. If you are migrating other Cloud applications (e.g. Confluence Cloud to an instance installed from Confluence Server), please see this page: Backing up and exporting data.

Note, if you are migrating JIRA Cloud applications and other applications (e.g. Confluence Cloud) to an instance hosted on your own servers, you will also lose a number of integration features that are native to Cloud. These can be re-enabled by configuring application links between your applications. See Using AppLinks to link to other applications for instructions. Contact support if you need assistance.

Instructions

1. Generate a backup of your JIRA Cloud application data

  1. Log in to your JIRA Cloud application site as an administrator.
  2. Generate an XML export of your JIRA Cloud application data by following the instructions in Exporting issues. Note that the export process will strip your cloud application and plugin licenses out of the XML, so the licenses will remain available in your JIRA Cloud site but not in your Server instance.

2. Install JIRA Server applications

You must use the latest version of JIRA Server applications.

  1. Download the latest version.
  2. Follow the instructions to install JIRA until you are instructed to run the setup wizard, then see step 3 below.

3. Import your JIRA Cloud application data into your JIRA Server application

Follow the instructions in on the setup wizard until you have configured a database (described in step 1 of Running the setup wizard). If you already have some data in your JIRA application installation, this step will overwrite it.

In step 2 of the setup wizard (Application Properties),  you will be asked whether you have existing data. Click import your existing data and follow the instructions to import the JIRA Cloud application backup that you generated earlier. Note, you may see the following message. This is a warning only, your import will still work.

 See Restoring data for more information.

For instances with large backups (2Gigabyte and up), we recommend importing the attachments separate from the Issue and user data. To do this:

  1. Unzip the backup file.
  2. Compress the activeobjects.xml and the entities.xml files only.
  3. Import that compressed file.

4. Copy across attachments

If you included your attachments in the export:

  1. Extract the backup file that was downloaded.
  2. Copy across the contents of the attachments folder to the $JIRA_HOME/data/attachments directory for JIRA Server.

5. Change the system administrator password

  1. Log in to your new JIRA application, using the following credentials: 
    • Username: sysadmin
    • Password: sysadmin
  2. Change the password immediately after logging in.

6. Check which plugins are installed on your JIRA Cloud application site

Any plugins that you are currently using with JIRA Cloud application will need to be installed in your JIRA application installation. For example, Gliffy, Tempo, etc. 

Choose > Add-ons The 'Find add-ons' screen shows add-ons available via the Atlassian Marketplace. Choose Manage add-ons to view the plugins currently installed on your JIRA applications. Choose Manage add-ons and note the plugins listed under the User-installed Plugins section. You will need to note the plugin names and versions.

7. Install plugins (add-ons)

For each plugin that you noted in the previous step, install it in your JIRA applications. You must install a version of the plugin that is equal to or later than the plugin version that was installed in the cloud. Atlassian does not provide support for data that is downgraded as a result of installing an older version of a plugin.

See Managing add-ons for instructions on how to install a plugin. You will need to manually add the plugin license keys.

The Support Tools Plugin that comes bundled with JIRA will get disabled after completion of the migration. Look it up under "All add-ons" in the Manage add-ons section to re-enable it.

Version matrix for imports

The following table tells you which version of the JIRA Server platform to use when migrating from JIRA Cloud applications. The version number is dependent on when you exported your data from JIRA Cloud applications. 

(info) We recommend that you use the latest JIRA version unless otherwise specified below. Only use the versions listed below if you cannot use the latest JIRA platform version.

Date when export was made Version of JIRA Server platform to use
Prior to 3 Dec 2012 Contact support for assistance
3 Dec 2012 — 16 Dec 2012 5.2.1
17 Dec 2012 — 20 Jan 2013 5.2.2
21 Jan 2013 — 6 Feb 2013 5.2.5
7 Feb 2013 — current Use the latest version available

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