This page describes the migration path that you can can follow in order to migrate Xray data from Jira Server / Data Center to Jira Cloud.

Server/DC vs Cloud - Product Comparison

If you are looking to migrate from Jira Server/DC to Jira Cloud, you need to consider the differences between Xray Server/DC and Xray Cloud. These differences might affect how your users work and interact with Xray.

The ideas, goals, and major features are the same. However, while there is great similarity between them, there are a few subtle differences between the two versions, this is mainly due to:

Jira architecture - The way apps work in Server and Cloud is completely different. In Server, apps can integrate with many aspects of Jira, while on Cloud, there are a lot of integration points missing, e.g. JQL functions, Project Templates, etc
Product Age - Xray Cloud is a newer product. Therefore, some of the features are not yet present (e.g. Automated Step Library, Historic Test Coverage report), although we plan to include these features in future releases. Also, we took the opportunity to improve some features (e.g. Project Level Settings).

For a full comparison between the Server/DC and Cloud versions of Xray, please refer to Xray Server and Xray Cloud.

Jira Cloud Migration Assistant

Atlassian provides an app called Jira Cloud Migration Assistant which helps users assess and migrate all the information from Jira on-premises to Jira Cloud. Jira Apps can also integrate with this assistant, making it easier to migrate all the data at once.

Currently, Xray does not yet support the Jira Cloud Migration Assistant. We plan to provide this integration in early 2021.

Xray Cloud Migration Scripts

Although there isn't support for the Jira Cloud Migration Assistant yet, the Xray team has created some scripts that can help you migrate your data today.

These scripts are written in Python and are using the Xray REST and GraphQL APIs to fetch the Xray information from Xray Server/DC, and then import this information into Xray Cloud.

The scripts will not create new issues in Jira Cloud. The Xray issues must have already been migrated. Therefore, you first need to migrate the issues using the:

XML export/import process
Jira Cloud Migration Assistant

The scripts will fill the gaps, namely:

Test specifications
Test Repository folders
Relations between Xray issues/entities, e.g. Tests in Test Plans, Tests in Test Sets, Preconditions, etc.
Test Runs

Depending on the number of issues, the migration scripts can take a considerable amount of time to execute and migrate all the data. Please plan ahead and do a Proof-of-Concept in a Jira Test instance first.

Clone or Download

These scrips are publicly available and free to use in our GitHub:

https://github.com/Xray-App/xray-cloud-mig

Please clone or download the repository and make any changes as needed.

Feel free to contribute and submit pull requests.

This page only contains a brief description of how the script works. Don't forget to follow the instructions on the README file in the repository.