How to import a project from a Jira Server application to a Jira Cloud application

Still need help?

The Atlassian Community is here for you.

Ask the community

Project imports are not currently available for Jira Cloud. This article outlines one of the workarounds to provide this functionality.

Migrating only specific projects to cloud or merging with an existing cloud site aren't currently supported. However, we're working on new tools to support this. If either of these scenarios apply to your migration, we recommend watching the feature request to stay updated or signing up for the early access program (EAP) for the new Jira Cloud Migration Assistant.

If the EAP isn't an option for you, there are a couple of workarounds you may want to consider, outlined here.

Suggested workaround

As per Restoring a Project from Backup, the Jira Server applications need to run identical versions in order to import the project successfully (please check all the requirements). This means we may need to prepare two Jira Server applications for importing if your Jira Server application is not in the latest version available. To do this:

  1. Follow Migrating from Jira Cloud to Server to set up a staging Jira Server application, using the data from your Jira Cloud application. We'll refer this Server application as Staging Jira A from here.
  2. Create a backup of your current Jira Server application as detailed in Backing up data.
  3. If your current Jira Server application is the same version as the one set up in step 1, proceed to step 6. Otherwise, continue with the steps below.
  4. Set up a new instance of Jira Server, using the backup from step 2 to restore (and upgrade) the instance. Follow the guide in Upgrading Jira applications to do this. We're going to call this Staging Jira B.
  5. Once the upgrade is successfully completed, generate a backup for Staging Jira B.
  6. Follow the Restoring a project from backup guide to restore all the required projects from Staging Jira B to Staging Jira A using the backup that was generated.
  7. Our Importing issues docs instruct how to take the data from Staging Jira A and restore it to the Jira Cloud application.

    This will completely overwrite the Cloud application and erase all existing data.

Alternative options

If the history of the issue is not required, you might consider the option to FIZME Importing Data from CSV as outlined in How to prepare a database export for a CSV Import from a JIRA Server application to a JIRA Cloud application. Importing attachments may require several manual modifications to the CSV file.

 Alternatively, if you are looking to migrate:

  1. Projects from a Jira Cloud site to another Jira Cloud site: See How to migrate projects from one Jira Cloud application to another.
  2. All of your data from Jira Server to Jira Cloud: See Migrate from Jira Server to Jira Cloud.

There are some restrictions that apply here, namely Active Objects data (so anything stored by plugins such as Jira Service Desk or Agile) is not fully migrated. For example:

  • Jira Service Desk cannot be migrated in a project import - this is tracked in JSD-2741 - Getting issue details... STATUS .
  • Jira Agile sprints and ranking data will only be migrated across in Jira 7 and higher. Boards will not be - this is tracked in GHS-10577 - Getting issue details... STATUS .

No other data from apps will be migrated in project imports, please keep this in mind.

Stay up to date

There are two open requests to support project imports to Jira Cloud:

JRA-40464 - Getting issue details... STATUS

JRACLOUD-31806 - Getting issue details... STATUS  

Last modified on Sep 26, 2019

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.