How to perform a cloud-to-cloud migration for Jira

This page describes how to use cloud-to-cloud migration for Jira to migrate your users and projects from one cloud site to another.

To begin a cloud-to-cloud migration, you need to log in to the cloud site you want to migrate your users and projects from, known as the source site.

1. Access the cloud-to-cloud migration feature

1. Go to Settings > System.

2. Select Migrate cloud site from the left navigation menu.

Open

From the Migration overview screen, you can select Start reading to read our documentation outlining important things you need to know before migrating. You can also select Plan your migration from the left navigation menu to access our documentation at any point during your migration.

2. Create a migration

Once you’re ready to begin migrating, select Manage migrations. This will take you to the Migration dashboard, which can also be accessed from the left navigation menu.

The dashboard lets you see all your migrations in one place. It will be empty until you create a new migration. To do so, select Create new migration.

3. Select your destination site

First, enter a name for your migration. This will help you identify the migration on the dashboard if you need to create more than one migration.

Next, select the cloud site you want to migrate your users and projects to, known as the destination site. Only sites that you have organization admin or site admin access to will appear in this list. If you don’t see your site in this list, it may be because:

• you don’t have organization admin or site admin access to your destination site

• your destination site is not under the same organization as your source site

If your source and destination sites are under different organizations, you’ll need to transfer one of the sites to the other organization. Learn how to transfer products to another organization

If you want to migrate to a new site, create a new site and add it to your organization.

Open

Once you’ve selected your destination site, select Choose projects to add projects to your migration.

4. Choose projects to migrate

You can choose to migrate all or some of your projects. All issues, attachments, and configurations related to the projects you select will be migrated. Currently, team-managed projects in Jira Software are not migrated. We recommend checking what we migrate with the Jira cloud-to-cloud feature in the early access program.

Users and groups are automatically added to your migration. Currently, we migrate users and groups separately, which means users won’t be added to groups and they won’t have product or project access. You’ll need to manually add users to groups after migration.

Once you’ve selected projects, select Check for conflicts to proceed.

5. Check for conflicts

Before you can run your migration, we run checks to confirm that your destination site is correctly set up for your migration and to identify potential conflicts or unwanted settings. When you reach this step, we also save your migration, and it will appear on the dashboard.

At this point, you can proceed to review your migration, but if the checks resulted in any warnings or errors, you’ll need to resolve them before you can run your migration.

What we check for:

• Your destination site has the same Jira products as your source site, even if you won’t be migrating data from the other products. This will reduce the chance of your migration failing. If there’s a product you don’t want to use after migrating, set up a free trial for that product, then deactivate the trial after your migration is complete.

• The user limit on your destination site won’t be exceeded after migration. The number of users with product access after migrating should be less than the maximum allowed under the plan on your destination site. If you need to increase the user limit, upgrade your plan.

• Projects don’t already exist on your destination site. All projects on your destination site must have unique names and project keys after migration. This includes the history of any changed or old project keys. If duplicate projects are found, you’ll need to change the project name or key on your source site, delete the duplicate projects on your destination site, or remove the affected projects from your migration.

• Projects aren’t available to the public, unless you’ve allowed anonymous or public access. We migrate project permissions as they’re configured on your source site. In some cases, your project permissions may allow public access, which means anyone on the internet can access your projects and related data in the destination site after they’ve been migrated. If you don’t want to allow people to access this data in your destination site without logging in, update the permissions on your source site before migrating.

6. Review your migration

On this screen, you’ll see a summary of your migration. This summary will outline how you’ve configured your migration, how many projects you’ve selected, and provide an estimated time required to complete your migration. Below the summary, you’ll see a breakdown of the projects you’ve selected.

Users, groups, and individual projects are all marked with a pre-migration status, indicating whether that entity is ready for migration. There are three possible pre-migration statuses.

If you have errors from the previous step that you haven’t resolved, you’ll need to go back to do so by selecting View errors and warnings at the top of the screen or Back at the bottom of the screen. CHECK and FIX statuses are all related to warnings and errors from the previous step.

Once you've resolved all warnings and errors and reviewed your migration, you can proceed to run your migration.

7. Run your migration

Once you run your migration, you’ll be redirected to the dashboard. Use the dashboard to view the progress and status of all your migrations.

Select the More actions (•••) menu to access quick actions for any migration, including to:

• run the migration

• edit the migration (add or remove projects from saved migrations)

• check for conflicts

• go to the destination site

To see the detailed progress of any migration, select View details for that migration. On the View details screen, you’ll see the progress of users, groups, and individual projects. While a migration is running, the migration status of users, groups, and projects will keep changing. There are five possible migration statuses.