• Products
  • Documentation
  • Resources

Run pre-migration checks, review, and run a Jira migration

After you create a migration plan, the Jira Cloud Migration Assistant runs a set of pre-migration checks to make sure your data can be migrated to cloud.

It checks that, for example:

  • Cloud products are installed in the destination site

  • Users and customers have unique and valid email addresses

  • You don’t exceed your user or storage limit

Run pre-migration checks

To run pre-migration checks:

  • Progress through your migration plan until you reach the Pre-migration checks screen

  • View the details of your migration plan from the Migrations dashboard

To improve pre-migration efficiency, the results of successful checks are stored once a pre-migration check run is complete.
These results are then utilized to speed up subsequent pre-migration checks for the same migration plan, avoiding the need to run the checks again from scratch. However, this cache of successful results is only kept for 12 hours. After this period, the cached results are automatically removed, and all pre-migration checks will run again.

Learn more about pre-migration caching in JCMA

Pre-migration checks in the assistant.

The pre-migration checks are divided into the following groups:

  • System

  • Users and groups

  • Customers

  • Projects

  • Cross-project boards and filters

  • Advanced Roadmaps plans

  • Apps

You can expand each check to see information on how to fix the related problems.

Learn how to solve common problems shown by checks

Review your migration

After you’ve reviewed and fixed the checks, you can proceed to reviewing your migration.

To review your migration:

  • Progress through your migration plan until you reach the Review migration screen

  • View the details of your migration plan from the Migrations dashboard

Details of a migration plan shown on the "Review your migration" screen.

When reviewing the migration, it’s useful to download the pre-migration report. It shows problems that require your attention, but also provides many details on the data that you’re migrating.

Learn how to view the details of your migration plan

Run or save your migration

After you reviewed the details of your migration, you can run or save it. In both cases, it will be saved to the dashboard where you can see the details and monitor the progress if you decided to run it.

  • To run your migration, select Run.

  • To save your migration for later, select Save.

You’ll be moved to the Migrations dashboard where you can see your migration and monitor the progress.

Migrations dashboard with a list of migration plans.

Next steps

Once you’re done, check the details of your migration or see how it’s progressing.
Learn how to view the details and monitor the progress


More information and support

We have a number of channels available to help you with your migration.

Support for Atlassian Server products ends in February, 2024. Learn more about the Server end of support timeline.

Additional Help