Documents to help you prepare to migrate your Atlassian Server or Data Center products.
You can reduce the risk of running into issues, or the migration failing, if you conduct some manual checks in your Server/Data Center and Cloud sites.
1. Check for group conflicts
Make sure that groups from your Cloud site don’t have the same names as groups that you’re migrating, unless you want to merge them.
If there are name conflicts:
Users from the Server group will be merged into the Cloud group.
Users from the Server group will inherit the permissions of the Cloud group.
This can include Cloud groups with Jira product access that have the same name as Confluence groups that you’re migrating. That’s because users and groups are managed in a central place in Cloud, regardless of the product they belong to.
If you don’t want this to happen, you’ll need to make sure all groups across Server and Cloud have unique names before running your migration.
The following groups manage admin access and are blocklisted. They will not be migrated at all:
Users in these groups will still be migrated, so if you want them to be in one of the blocklisted groups you’ll need to manually add them after migration.
2. Check for space key conflicts
Make sure that spaces from your Cloud site don’t have the same space key as the ones you’re migrating. When you migrate a space with a duplicated key, the migration will fail.
If you find conflicts, you can:
Delete duplicate spaces from your Cloud or Server instance
Reset your Cloud site
Exclude spaces from migration
If a conflict is caused by a previous test migration, you can reset your cloud site before migrating. Learn how to reset your Confluence Cloud site
Once you’re done, you can start migrating Confluence data. Learn how to migrate Confluence data
More information and support
We have a number of channels available to help you with your migration.
For more migration planning information and FAQs, visit the Atlassian Cloud Migration Center.
Have a technical issue or need more support with strategy and best practices? Get in touch.
Looking for peer advice? Ask the Atlassian Community.
Want expert guidance? Work with an Atlassian Partner.
Support for Atlassian Server products ends in February, 2024. Learn more about the Server end of support timeline.