Plan your Cloud migration
Documents to help you prepare to migrate your Atlassian Server products.
Supported versions for the Jira Cloud Migration Assistant
Upgrade to Jira Cloud Migration Assistant 1.7.3 or higher
To give you a more stable and reliable migration experience, we’ve improved the way attachments and other media files are migrated.
Starting September 19, 2022, we recommend you upgrade to Jira Cloud Migration Assistant 1.7.3 or higher for all your migration needs in future.
Starting January 31, 2023, you won’t be able to use 1.7.1 and lower of the Jira Cloud Migration Assistant.
Learn more about this announcement and how to upgrade.
For any further details or technical concerns, contact us.
To use the Jira Cloud Migration Assistant, you need to be on Jira Server or Jira Data Center version 7.6.0 or later. To migrate Jira Service Management, you need to be on Jira Service Management 3.9.0 or later. Learn how to upgrade Jira applications
If you're on an unsupported Server or Data Center version and don't have active maintenance on your server license (which is required to upgrade), you can use a free trial license to upgrade in preparation for your migration. Learn more about how to migrate to Cloud with an expired license
Limited recovery support (Data Center only)
The Jira Cloud Migration Assistant supports limited recovery in the case of a server failure during migration. This capability is only available to the Jira Cloud Migration Assistant when installed on Data Center. To maximize recovery capabilities, we recommend only running one migration at a time per two Data Center nodes.
In the case of a server failure during migration, the Jira Cloud Migration Assistant will:
if the server failure occurs during export, automatically recover the migration up to two times, as long as there are two Data Center nodes per migration and both don’t crash at the same time
if the server failure occurs during import, automatically recover the migration an unlimited number of times, as long as there are two Data Center nodes per migration and both don’t crash at the same time
In the event that all Data Center nodes crash, then recovery (as outlined above) isn’t guaranteed. However, recovery may still be possible if one node (per migration) is restarted within three minutes.
Bitbucket
If you’re migrating Jira and need to integrate Bitbucket Server or Bamboo, refer to the Application links version matrix to check you’re using a compatible version of Bitbucket Server or Bamboo before you start. Learn more about app links versions
More information and support
We have a number of channels available to help you with your migration:
for migration planning information, visit the Atlassian Migration Program website
for technical issues or support with strategy and best practices, get in touch with our support team
for peer advice, ask the Atlassian Community
for expert guidance, work with an Atlassian Partner
Was this helpful?