On this page:

Migrations to Jira Cloud

By combining the Cloud Migration Tool and Configuration Manager for Jira Cloud apps, you can successfully migrate projects and issues from Jira servers or data centers to destination Jira Cloud sites.

Create your first cloud connection

When you open the Move to Jira Cloud home page for the first time and don’t have any connections to Jira Cloud sites yet, you’ll be able to quickly create your first-ever connection to a Jira Cloud site. 

Create cloud connection option allows you to connect to a Jira Cloud site without leaving the Manage Migrations page. Then, you can proceed to a migration creation without switching pages - a single place to kick start your migration. Check out the Cloud Connections document to learn more about creating cloud connections.

Migration reports

We’ve added three reports with summarized information on your past and current migrations on top of the Manage migrations page:

• The Projects report shows the count of the migrated, not migrated, and being migrated (in progress) projects.

• The Issues report shows the count of the migrated, not migrated, and being migrated (in progress) issues.

• The Last migration report displays information about the last successful migration: the projects and issues migrated during the last migration and its duration.

Create migrations

To create migrations to Jira Cloud sites:

1. Log in as a user with the Jira System Administrators global permission to your Jira Server/Data Center instance.

2. Choose the cog icon at the top right corner of the screen, then choose Configuration Manager. 

3. Open the Move to Jira Cloud page from the left-side menu.

4. Create: Click on the New Migration button on the page to create a migration.
   The first thing you’ll see is the Connect step of the migration wizard:

   

5. Connect: Name your migration and choose a Jira Cloud connection if you already have one created previously. Otherwise, click the New connection or + button to create one. 
   Learn more about creating cloud connections and the Atlassian credentials you need to provide.

6. After you have named your migration and created/chosen a connection, click the Select button to move to the next migration phase - selecting projects.

7. Select projects: On the Select step of the wizard, click Add projects to the migration and select projects from the current Jira instance.

8. Select boards (optional): You can also click the Add boards to the migration link. This option will allow you to select boards outside (unrelated to) the selected projects and add them to the migration.

   

9. Analyze: Click Analyze to move no the next phase of the migration.

10. In the Analyze phase, review what will be added to and modified on the cloud - projects, configuration elements, and users. If any problems or conflicts are detected between the source and destination cloud projects and their configuration elements and users, the analysis will alert you with information and details for each case. Learn more

11. Review any conflicts and errors detected in projects, configuration elements, or users. Resolve conflicts before proceeding with the migration.

12. If you have configuration errors or conflicts, you need to resolve them and rerun the analysis.

    

13. Migrate: After resolving all errors and rerunning the analysis, click the Migrate button to run the migration.

14. Review the result of the migration. Click the Access Report button to review what exactly has been migrated.
    You can also view if any warnings and errors have been encountered during the migration of issues and issue links. Learn more about the report

    

15. Navigate to the Jira Cloud site and browse the migrated projects.