How to uninstall the bundled Jira Cloud Migration Assistant (JCMA) App

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

The Jira Cloud Migration Assistant (JCMA) App is bundled with Jira version 8.14 and above.

As a result, it is not possible to uninstall it via the Universal Plugin Manager interface (Jira Admin → Manage Apps). The app can be upgraded to a newer version, and that newer version can be uninstalled, but the bundled version cannot be uninstalled.

A Jira Administrator may wish to remove this plugin for some reason.

Solution

  1. Delete the file JIRA_INSTALL/atlassian-jira/WEB-INF/atlassian-bundled-plugins/jira-migration-plugin-n.n.n.jar, where n.n.n is the version number of the bundled JCMA plugin

  2. Restart the Jira service

  3. Repeat steps 1-2 for each Jira node in the cluster (if Jira Data Center)

The above steps involve modifying Jira outside of the default configuration. While we have validated there is no negative impact on all versions of Jira 7, and Jira 8 up until Jira 8.20.5, it's possible that this is not the case in a future version of Jira.

For this reason, we recommend that you take due diligence, perform the procedure in a non-prod environment and check for any negative effect on Jira. Checking the atlassian-jira.log file for references to com.atlassian.jira.migration.jira-migration-plugin is a good step to determine if there has been a negative interaction from removing this plugin

Atlassian Support is not able to provide further guidance or support for this procedure

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.