Getting started

App data migration begins after the Jira or Confluence admin has migrated core product data to the cloud site. This page explains how Jira and Confluence app developers can prepare their data from server to cloud.

There are three main steps when migrating your app data:

Pre-migration: Prepare your server and cloud apps for data migration.
Migration: Migrate your data with the App migration platform.
Post-migration: Configure your cloud app based on migration updates.

App migration is now available as a public beta feature with the Jira Cloud Migration Assistant and Confluence Cloud Migration Assistant. This means that your customers will no longer need to be part of the Early Access Program (EAP) for JCMA and CCMA.

Also, there is no need to use the app migration feature flag ( i.e. migration-assistant.app-migration.feature for CCMA and com.atlassian.jira.migration.app-migration.feature for JCMA ) to migrate their app data to cloud.

Pre-migration

Pre-migration setup on your cloud app

If you want to opt for your cloud app to be notified of app migration events, you can register webhooks with the App migration platform. You can find more details on the register webhooks page.

Pre-migration setup on your server app

To enable app migration in your server app, you will need to implement a listener to register your server app with the App migration platform. You can find details on the register listener page.

Migration

Migration on your cloud app

If you have registered a listener in server, then you must implement the Status API to send progress and settle the transfer when completed. You can find details on the Progress reporting and Status API page.

You can find more details about retrieving data, requesting mappings and sending feedback here:

Migration on your server app

You can find more details about sending data, requesting mappings and fetching feedback here:

Further steps

We have created sample apps that demonstrate how to use the App migration platform. We also have some tutorials that explain how you can use the App migration platform.

Please visit our support page for steps on how to get help from Atlassian.