Documentation
  • Overview
  • Atlassian Cloud
    • Intercom for Jira Cloud
      • Get started
      • Guides
        • Jira administrators
          • Setting up
          • Managing app features
          • Managing notifications
            • Configuring notifications on issue updates
            • Configuring notifications for specific issue transitions
          • Managing visible Intercom data fields
          • Managing the Intercom app configuration
          • Configuring the app user
          • Revoking Intercom connection
          • Reconnecting broken Intercom connection
        • Jira users
          • Managing Intercom conversation links
          • Inspecting linked Intercom conversations
          • Commenting linked Intercom conversations
          • Searching and reporting
      • Concepts
        • App workflow
      • Forge migration
      • Announcements
      • FAQ
    • Travis CI integration for Jira
      • Getting Started
      • FAQ
  • Atlassian self-hosted
    • Intercom for Jira Data Center/Server
      • Get started
      • Guides
        • Jira administrators
          • Setting up
          • Managing Jira app features
          • Managing Intercom app features
          • Managing notifications
            • Configuring notifications on issue updates
            • Configuring notifications for specific issue transitions
          • Managing visible Intercom data fields
          • Revoking Intercom connection
          • Migrating to Intercom for Jira Cloud
        • Jira users
          • Linking Intercom conversations
          • Inspecting linked Intercom conversations
          • Commenting linked Intercom conversations
          • Searching and reporting
        • Intercom teammates
          • Adding the app to Inbox
          • Creating new Jira issues
          • Linking existing Jira issues
          • Managing linked Jira issues
      • Security Statement
      • FAQ
  • Intercom
    • Jira Cloud for Intercom
      • Get started
      • Guides
        • Intercom administrator
          • Setting up
          • Managing fields on the create issue form
          • Inspecting app information
          • Managing the Intercom app configuration
          • Changing the Intercom app user
          • Restricting app access
          • Uninstalling the app
        • Intercom teammates
          • Adding the app to Inbox
          • Creating new Jira issues
          • Linking existing Jira issues
          • Managing linked Jira issues
      • Concepts
        • Jira connection
      • FAQ
      • Privacy & Terms
  • Trust
    • Our privacy program
  • Legal
    • Privacy Policy
    • Service Level Agreement
    • End User License Agreement
    • Data Processing Agreement
    • Subprocessors
Powered by GitBook
On this page
  • Know before you migrate
  • Migration
  • Post-migration
  1. Atlassian self-hosted
  2. Intercom for Jira Data Center/Server
  3. Guides
  4. Jira administrators

Migrating to Intercom for Jira Cloud

PreviousRevoking Intercom connectionNextJira users

Last updated 2 years ago

Know before you migrate

Intercom for Jira provides roughly the same feature set for Data Center/Server and Cloud. The most notable difference is the Intercom integration. On Jira Data Center/Server, this is part of the Jira app itself, and you have to set up and configure an Intercom app yourself. On Jira Cloud, the Intercom integration is a (free) that ToolsPlus is hosting for you. All you have to do is install and connect it to your Jira Cloud instance.

Migration

The migration of Intercom for Jira data from Data Center/Server to Cloud is a two-step process. First, you migrate your Jira core data (issues, projects, etc.) . After that, backup your Jira Data Center/Server data and run on the backup to migrate Intercom for Jira data to your Cloud instance. The following guide will explain these steps in detail.

Migrate Jira data using the Jira Cloud Migration Assistant Follow the Atlassian documentation steps on migrating. JCMA will inform you that it cannot migrate Intercom for Jira automatically for you. This is expected because JCMA migration is not implemented in Intercom for Jira. Instead, you can use the migration script provided in the next step to migrate Intercom for Jira data to Cloud.

Verify that the issue keys remain the same

Once the JCMA migration is complete, double-check that your issue and project keys on Data Center/Server instance match the issue and project keys on your Cloud instance. This is important for the Intercom for Jira data migration to work correctly.

Migrate Intercom for Jira data using the migration script The Intercom for Jira Migration Script is available on GitHub:

Re-running the migration script

It's safe to run the migration script multiple times. The script overwrites previously written data. There is no risk of accumulating data from multiple runs.

Once the migration script completes, follow the post-migration steps below.

Post-migration

Almost all of your Intercom for Jira data should now be migrated to your Jira Cloud instance. There are, however, a few last steps to complete the migration.

Connect your Jira projects to Intercom The Intercom credentials for Intercom for Jira Cloud are different from the Jira DC/Server version, hence, the migration script could not migrate that data.

in the repository contains extensive documentation on preparing and running the migration script. Start with the prerequisite steps before proceeding to the usage section.

Install Intercom for Jira on your Jira Cloud instance If you have not yet done so, .

To get Intercom for Jira on Cloud working, .

Re-create workflow post functions for Intercom notifications If you have been using workflow post functions to notify linked Intercom conversations on specific issue transitions, please .

Install Jira Cloud for Intercom On Jira DC/Server you have been managing your own Intercom app which ran off your Jira instance. On Jira Cloud ToolsPlus is hosting this app for you for free. If you would like to continue using the Intercom app feel free to .

For additional details on how Intercom for Jira (the Intercom inegration for Jira) and Jira Cloud (the Jira integration for Intercom) work together, have a look at the .

The README file
connect migrated Jira projects to Intercom
recreate those post functions on your Jira Cloud workflows
install it from the Intercom app store
overview section in the setup documentation
separate app
using the Jira Migration Assistant (JCMA)
the provided migration script
your Jira core data from your Data Center/Server instance to your Cloud instance
https://github.com/toolsplus/intercom-for-jira-migrationgithub.com
install Intercom for Jira on your Jira Cloud instance