Documents to help you prepare to migrate your Atlassian Server products.
A collection of topics that help prepare you to migrate your apps to the Cloud.
Ensure you’re ready to migrate with these pre-migration checklists for Jira, Confluence, and Bitbucket Server or Data Center.
Documents that walk you through using the Confluence Cloud Migration Assistant to migrate to Cloud.
Documents that walk you through using the Bitbucket Cloud Migration Assistant to migrate to Cloud.
Documents to help you use Jira Site Import to migrate to Cloud.
Resources to help get started and testing after you migrate.
Everything you need to know about moving your data from one cloud site to another.
Depending on your needs, you may need to use one or more of the following methods to migrate to Jira Cloud. Read Choose a Cloud migration method for advice on how to choose the migration method that meets your needs.
Once you’ve chosen a method, you can proceed to the Jira Cloud Migration Assistant pre-migration checklist to make sure you’re ready to migrate.
Jira Cloud Migration Assistant (recommended)
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.
For any further details or technical concerns, contact us.
The Jira Cloud Migration Assistant is a free Atlassian app that can be installed on your Jira Server or Data Center instance. The migration assistant is the easiest and most reliable way to move from Server or Data Center to Jira Cloud.
Use this method to migrate:
some projects to Cloud
everything to a new Cloud site
to a new or existing Cloud site
your data all at once or in phases
The Jira Cloud Migration Assistant can also help you merge multiple Jira Cloud sites.
See the full list of what is and isn't migrated with the Jira Cloud Migration Assistant.
Jira Cloud Site Import
Site Import will no longer be available for Server to Cloud migrations
From February 1, 2022, we’ll discontinue Server to Cloud migrations using Site Import depending on the number of users you’re looking to migrate.
If you’re looking to migrate:
1-10 users - Site Import will be available until Jan 31, 2022
11 - 100 users - Site Import will be available until Feb 28, 2022
101-250 users - Site Import will be available until Mar 31, 2022
251 - 1000 users - Site Import will be available until Apr 30, 2022
More than 1000 users - Site Import will continue to be available until further notice.
To view the number of licensed Jira Server or Data Center users, see the Viewing your licensed user count section on the Licensing your Jira applications page.
We recommend you use the Jira Cloud Migration Assistant for all your migration needs. The Migration Assistant offers several benefits including Apps and Jira Service Management migrations. We’ll soon support Advanced Roadmaps migrations.
Using Jira Site Import to migrate from Server to Cloud involves using a Jira Server or Cloud XML backup to import everything from one site into Cloud. This method will overwrite any existing data in your Cloud site, so is only recommended when you’re moving to a new Cloud site.
Jira Cloud CSV import
This is not a recommended migration method due to its limitations. This method allows you to import issues from Jira Server or Cloud into a Cloud site using CSV import.
Only use this method when Jira Cloud Migration Assistant or Jira Cloud Site Import are not options for your needs.
Merge in Jira Server
If you need to either consolidate Server or Data Centers instances or merge with an existing Jira Cloud site, merging sites in Jira Server may be a prerequisite step to your migration to Cloud. However, you may be able to skip this step depending on which migration method you choose. For example, if you’re using the Jira Cloud Migration Assistant, you don’t need to consolidate Server instances before importing issues to Cloud.
Use this method when you need to:
merge multiple Jira Cloud sites
merge multiple Jira Server sites
import only specific projects from one Cloud site to another
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?