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.
Migrate your Jira data with the Jira Cloud Migration Assistant. This is the recommended way to migrate.
Migrate your Confluence data with the Confluence Cloud Migration Assistant. This is the recommended way to migrate.
Documents that walk you through using the Bitbucket Cloud Migration Assistant 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.
A set of optional best practices that you can apply to your migration.
Prevent migration failure by upgrading to the latest versions of our Cloud Migration Assistants
We are ending support for all older versions of Jira Cloud Migration Assistant and Confluence Cloud Migration Assistant.
You won’t be able to use the following versions:
Jira Cloud Migration Assistant 1.7.1 and lower
Confluence Cloud Migration Assistant 3.3.6 and lower
We are improving our migration tooling and expanding their existing capabilities. For a smoother and more stable migration experience, we recommend upgrading to the latest version of Jira Cloud Migration assistant within six weeks of it release.
For any further details or technical concerns, contact us.
This information applies to both the Confluence Cloud Migration Assistant and Jira Cloud Migration Assistant. This does not apply to other Server to Cloud migration strategies.
How user migration works
The migration assistants use email addresses as the key identifier for your users. The first time you migrate, the Migration Assistant will copy all the users from your Server and create Atlassian Accounts for them in Cloud using their email addresses. These users will only be added to your Cloud license if they are a member of a group with license permissions.
Every migration, after the first, the Migration Assistant will link space or project data to the existing email addresses in Cloud rather than recreating those users. This means that it will be much faster to migrate users and groups from the second migration onwards. The estimated time to migrate does not take this into account.
Recommendations for large userbases
If you have a large userbase, generally over 2,000 active and inactive users, we recommend migrating all your users and groups without any spaces or projects first. This can happen while your users are still working in Server, as no space or project data will be extracted (meaning no downtime). Then, when you come to migrate spaces or projects later, it will be a faster migration with a shorter downtime.
If you're using the Jira Cloud Migration Assistant you can also choose to migrate only the users referenced in the projects you are migrating. This can reduce the number of users you need to migrate and will mean a shorter downtime.
Assessing and preparing your users for the migration
This information applies only to the Jira Cloud Migration Assistant. The assessment isn’t available for Confluence right now.
In Atlassian Cloud, every user must have a valid and unique email address, which often isn’t the case for users in Server and Data Center products. Users whose email addresses don’t meet these requirements will block your migration.
You can use the Jira Cloud Migration Assistant to assess your users and identify the ones whose addresses are invalid or duplicated. You can complete this assessment at any time, even if you’re not planning to migrate anytime soon. It will help you understand the state of your users and how many updates will they need before you can migrate.
After completing the assessment and viewing the results, you can also choose one of the suggested options to automatically fix the email addresses during migration, for example by merging all duplicate accounts or migrating invalid users as Former users.
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?