Migration from Jira Cloud to Jira Data Center

If you decide to migrate your Jira instance from Cloud to Data Center you can also migrate Project Team app data. The migration process consists in two major steps: export of app data from Jira Cloud, followed by import of app data into Jira Data Center.

This page describes the steps to export Project Team data from Cloud and how to import it in a Data Center instance.

Prerequisites

After import, you can revert to the original attachment size limit.

  • Ensure that you have the newest version of Project Team app installed in your Jira Data Center instance.

Step 1: Exporting app data from Jira Cloud

The first step in the migration process is to export Project Team app data from your Cloud instance in JSON format.

Follow these steps to export the app data in JSON format:

  • Log in Jira Cloud as a Jira admin

  • Navigate to Jira Settings > Apps > PROJECT TEAM > Data Export page

  • Click the Start Export button to begin the export process. This might take a while, depending on the number of users from your Jira instance.

image-20240523-065247.png
  • When the export is finished, click download as JSON to export the data in a JSON file.

Step 2: Importing app data in Jira Data Center

Once you have the entities.xml file extracted from the Jira Cloud backup archive and the JSON file containing the exported app data from Cloud, you can proceed with the import of this data in the Jira Data Center instance.

Follow these steps to import the user custom field definitions and their values from Jira Cloud to Jira Data Center:

  • Log in as an admin to your Jira Data Center instance

  • Navigate to Administration > Project Team > Import From Cloud page

  • For Project Team Exported Data From Cloud, choose the JSON file generated previously

  • For Jira Cloud Exported Entity XML File, choose the entities.xml file extracted from the Jira backup for Cloud archive

  • You can check the Merge data option if you have imported the data once and want to re-import a file that now contains additional data. This will allow the new data to be imported, while the existing data will be preserved.

image-20240528-171019.png
  • Click Start Import to begin the import process

  • The import process will display a progress bar tracking the import of custom fields and associated user properties

  • In case the application is unable to map some of the users from the import file to the local Data Center users directory, it will display a notification message and once the import process is completed it will show a Download button that allows you to download the list of these users.