• 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

Save time while running your pre-migration checks

Upgrade to the latest version of Jira Cloud Migration Assistant to avoid rerunning time-consuming pre-migration checks. In the latest version, the results of successful pre-migration checks are stored to improve efficiency. These results are then used to speed up future checks, thus saving time.

Note:

  • It's recommended to run the pre-migration checks at least a few days before the migration day. This'll ensure that:

    • any modifications made to the data are validated and stored in the cache

    • the duration of running the pre-migration check is minimised, saving time on the migration day

  • The cached results are stored only for 30 days, beyond which they are automatically removed and all checks run again.

About eligible pre-migration checks and how caching works

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.

Still need help?

The Atlassian Community is here for you.