Migrating from JIRA Cloud to Server applications
This page is for people who are currently using JIRA Cloud, and wish to move to JIRA Server (a JIRA installation hosted on your own servers).
JIRA Cloud is typically ahead of JIRA Server, which means that some features may not be available after you've moved to JIRA Server.
If you want to move a project, not your entire site, see Restoring a project from backup.
On this page:
Limitations
JIRA Cloud applications are regularly updated with the latest features and improvements, which means they are a later version than the latest downloadable version of JIRA applications. If you want to migrate from JIRA Cloud applications to JIRA Server applications, be aware of the following limitations.
Migrating to JIRA Server
1. Back up
Back up your JIRA Cloud application data.
- Log in to JIRA Cloud as an administrator.
- Create an XML backup. For more info, see 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. Download the installer
Download the installer for your operating system – JIRA Core, JIRA Software, or JIRA Service Desk.
3. Install JIRA Server
Install your JIRA applications. For detailed instructions, refer to Installing JIRA applications.
Note that during the installation, you will be asked if you have existing data. This is where you can import your XML backup, as described in the next step.
4. Import your data from JIRA Cloud into JIRA Server
In step 2 of the setup wizard (Application Properties), you'll be asked whether you have existing data. Click Import your existing data, and follow instructions to import your XML backup.
When importing, you might see a warning that you're importing data from an earlier JIRA version. You can ignore it and continue with the import.
If your backup is 2 GB or more, import the attachments separately
For large backups, we recommend that the attachments are imported separately. To do this:
- Unzip the backup file.
- Compress the
activeobjects.xml
and theentities.xml
files only. - Import the compressed file in the setup wizard, as described above.
- Copy the contents of the
attachments
directory into the<home-directory>/data/attachments
directory for JIRA Server.
After the migration
5. Change the admin password
- Log in to your new JIRA application, using the following credentials:
- Username:
sysadmin
- Password:
sysadmin
- Username:
- Change the password immediately after logging in.
6. Check which plugins you have in Cloud
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 your plugins in JIRA Server
For each plugin that you noted in the previous step, install it in your JIRA applications. Make sure to install the latest version of the plugin. 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.
8. Reset the passwords for your users
After you finish migrating from JIRA Cloud to JIRA Server, you must reset the passwords for your users. To do this, you can either:
notify all users that they need to click Forgot password to reset their password. Learn how to send an email to all JIRA users.
- log in as sysadmin and reset everyone's password.
Well done! You've migrated your JIRA Cloud site into a JIRA Server instance.