Determine your user migration strategy

When planning your overall migration, it’s important to decide when and how you will migrate users. This will depend on:

• the Data Center instances you’re migrating

• whether you have users from external directories, which might require additional subscription in cloud

• if you plan to use Atlassian Guard Standard for SCIM user provisioning

We recommend taking the time to learn how user management works in cloud, and make a detailed plan of the tasks you’ll need to complete to migrate your user accounts. We recommend you think holistically about your cloud organization, and how changes to someone’s Atlassian account can affect all Atlassian cloud apps they have access to, not just those managed by your team.

User migration journey

Before you start, check the list of tasks you’ll go through in your user migration, including planning and preparing, and setting up cloud user management.

Get started with migrating users to Atlassian Cloud

User management differences in cloud

User management works differently in cloud. Understanding the basics will make your migration much easier. You’ll also get an idea on whether you need additional subscription to Atlassian Guard Standard.

How user management works in Atlassian Cloud

Activating your cloud migration trial

Cloud migration trials are cloud subscriptions equivalent to your current server license. They match your remaining license period in server and your current user tier, which will help you test or run actual migrations without extra cost.

Learn how to activate your Cloud migration trial

Pre-migrating users and groups before data

As part of the lift and shift strategy, we recommend that you pre-migrate users and groups. This is especially important for instances with over 2,000 active and inactive users. When you migrate users separately, we’ll later only migrate the differences, which will significantly speed up your subsequent data migrations.

To migrate users and groups separately, you’ll need to migrate all of them. If that’s not something you want to do, you can still choose to migrate a subset of users together with projects or spaces.

User migration options: All or a subset of users

We recommend to migrate all users, but you can still choose to migrate only a subset, especially if you have a smaller instance.

Here are some details on migrating users with the assistants:

Jira

You can use the Jira Cloud Migration Assistant to:

• Migrate users related to the projects you select to migrate

• Migrate all users from active internal and external directories without any project data

For Jira Service Management, the assistant can migrate customer accounts related to selected projects, or migrate all customer accounts without any project data.

Learn how to migrate with the Jira Cloud Migration Assistant

Confluence

You can use the Confluence Cloud Migration Assistant to:

• Migrate users related to the spaces you select to migrate (without groups)

• Migrate all users from active internal and external directories without any space data

When you select Users related to selected spaces, groups aren’t migrated. Only users who have commented on the page, created pages inside the space, have permissions to access the space, and users who are mentioned on the page are migrated. These users will be added to your cloud site, however, they will not have product access.

Learn how to migrate with the Confluence Cloud Migration Assistant

Bitbucket

You can use the Bitbucket Migration Assistant to:

• Migrate all users from Bitbucket Server to Cloud

• Migrate users who have been involved in any pull requests within or currently have at least read access to the repositories that were selected for migrations

• Migrate users who have been involved in any pull requests within the repositories selected for migration

Any users who have an invalid email address upon migrating to the cloud will be migrated as an inactive Bitbucket user.

Learn how to migrate with the Bitbucket Cloud Migration Assistant

How users and groups are migrated

Here are some details on how exactly we migrate users and groups.

Learn how Jira users and groups are migrated

Learn how Jira Service Management customers are migrated

Learn how Confluence users are migrated

Get started with your user migration

When you’re ready, check the tasks related to user migrations.

Get started with migrating users to Atlassian Cloud