Plan your Cloud migration
Documents to help you prepare to migrate your Atlassian Server products.
When migrating Confluence, you build a migration plan and fill it in with data. You can either include everything in a single plan or divide it into many migration plans.
Looking for information on assessments?
You can find information on app and user assessments in these collections:
Complete these steps:
Check what can be migrated with this option. Learn more
Update the assistant and allowlist required IPs and domains. Learn more
Check for possible data conflicts to avoid issues. Learn more
Complete the pre-migration checklist to prepare your environment. Learn more
Pre-migrate users, groups, and attachments before other data to reduce downtime. Learn more
Permissions:
To migrate, you need to be an admin in both the source instance and the destination cloud site.
To create a migration plan:
Open the Confluence Cloud Migration Assistant.
Select Create new migration.
On the Connect to your cloud site screen, provide the following data:
Example screen | Fields |
---|---|
|
Once you select a destination cloud site, you’ll be able to choose what to migrate.
You can add the following items to your migration plan.
Example screen | What you can migrate |
---|---|
|
Check how each data type is migrated and what are the best practices:
Users and groups: How Confluence users and groups are migrated
To add spaces to your migration:
In the Spaces section, choose one of the following options:
Option | Description |
---|---|
Migrate spaces | Migrate all selected Confluence spaces. |
Migrate attachments only | Migrate only attachments from the selected Confluence spaces. |
Skip spaces | Don’t migrate any spaces. |
2. Select the spaces you want to migrate.
3. When you’re ready, select Add to migration.
To add users and groups to your migration:
In the Users and groups section, choose one of the following options:
Option | Description |
---|---|
Migrate all users and groups from the Confluence directory | Migrate all users and groups from your Confluence users directory. If you’re looking to speed up your migration, this option is faster. When migrating only a subset of users, the assistant needs to check them against every space in Confluence, which takes time. |
Migrate users related to the selected spaces | Migrate only users that are referenced in the spaces you added to your migration plan, which includes users who:
When you choose this option, we always migrate some data connected to the spaces you’re migrating. This is to ensure that all mentions, comments, and page history stay active. |
Skip users | Don’t migrate any users and groups. |
2. When you’re ready, select Add to migration.
To add apps to your migration:
In the Apps section, choose one of the following options:
Option | Description |
---|---|
All | Migrate all apps that you marked as ‘Needed in cloud’ when assessing and preparing apps, and that have a migration path provided by the app vendor. |
None | Don’t migrate any apps. |
2. When you’re ready, select Add to migration.
Once you’re done, check for errors in your migration. Learn how to check for errors in your migration plan
Was this helpful?