Who can use this information?
App vendors who want to allow their customers to move app configuration and data from one Jira instance to another.
Jira customers who develop apps for internal usage and want to move the app configuration and data between Jira instances.
Developers who want to integrate apps with Configuration Manager for Jira (CMJ) for app data and configuration migration purposes.
On this page:
App configuration and data migration with CMJ
App Integrations is a platform we've built for Atlassian vendors who:
build Jira apps, and
want to add the ability for configuration and data migration to their apps.
The platform allows integrating your apps into our Configuration Manager for Jira (CMJ) app. CMJ is a Jira configuration and change-management tool. It is used by Jira admins to move and migrate all kinds of Jira configurations, like projects, custom fields, workflows, etc., from one instance to another.
We've developed an extension to CMJ to provide the same features for migrating app configuration and data to Jira admins. It is called Configuration Manager Service Provider Interface (SPI).
Integration is done with easy-to-use endpoints provided by the SPI. Vendors’ development teams must connect their apps to these endpoints to integrate with CMJ.
The interface has two versions: Server/DC SPI for Jira server apps and Cloud SPI for Jira Cloud apps.
Types of integrations
App Integrations offers two types of integrations. The type you choose depends on the Jira platform and the ability you want to build in your app.
Take a look at the Integration Types document for more guidance.
Integration with CMJ for server-to-server migrations
Integrate your app with CMJ, and your customers will be able to move your app’s configuration and data from one Jira Server/DC instance to another.
To allow such migrations, you need to integrate your server app with CMJ using the Server SPI’s endpoints. Learn more about this integration type
Integration with the Cloud Migration Tool and CMJ Cloud for server-to-cloud migrations
To allow your customers to move your app’s configuration and data from a Jira Server/DC instance to a Jira Cloud instance, you need to:
Integrate your server app with the Configuration Manager Cloud Migration Tool using the Server SPI’s endpoints.
Integrate the relevant cloud app with CMJ Cloud using the Cloud SPI’s endpoints.
Learn more about this integration type
Supported configuration types
The types of app configuration and data that can be moved or migrated are:
For server-to-server migration: workflow elements, custom fields, project elements, dashboards, arbitrary app data, and global configuration.
For server-to-cloud migration: workflow elements.
Already integrated apps
Many vendors have already integrated their apps with CMJ successfully. As a result, their customers are now able to move their app configuration and data from one Jira instance to another.
Go to the List of Integrated Apps document to see the apps already integrated with CMJ and their integration types.
Vendor integration corner
We’ve built convenient documents and developer guides that will lead your teams along the way to the integration. For the complete developer guides of each of the SPI versions, visit: