Cloud Connections

On this page:

Create cloud connections

With the Cloud Migration Tool and Configuration Manager for Jira Cloud apps, you can connect your Jira Server or Data Center instances to Jira Cloud sites. In addition, you can create a cloud connection from the Move to Jira Cloud home page and also during migrations.

After installing the Cloud Migration Tool and landing on its home page, you can easily create your first connection to a Jira Cloud site. That’s a quick way to make a cloud connection without leaving the Move to Jira Cloud home page.
Learn more about your options for creating connections to Jira Cloud sites.

Site admin or Оrganization admin permission required

You must be a Site or Organization admin in Jira Cloud to create connections to the cloud and migrate projects there. This means that the user email you provide on the New Connection page in the Cloud Migration Tool must be added to the site-admins or org-admins group on the Jira Cloud site.

You can learn more about the different аdmin roles in Atlassian’s documentation.

To create a connection to Jira Cloud:

  1. Log in as a user with the Jira System Administrators global permission to your Jira Server or Data Center.

  2. Choose the cog icon at the top right of the screen, then choose Configuration Manager. 

  3. On the Cloud Connections page, click the New Connection button to create a connection.

  4. Name your connection, and enter the URL of your Jira Cloud site, Atlassian account email, and API token. You can learn more about the Atlassian credentials, the API token, and why you need one for migrations here.
    The account must be added to the site-admins or org-admins group on the Jira Cloud site. Otherwise, the Cloud Migration Tool won’t allow you to create the connection.

  5. Test your connection. If the test passes, you’re all set to save your connection.

  6. Click Create button to establish the connection and save it.

Manage cloud connections

You can review and manage your Jira Cloud connections at any time on the Cloud Connections page. The changes you can make to an existing connection are Rename, Edit credentials, and Delete.

Rename

If you want to give a new name to an existing cloud connection, you can rename cloud connections at any time.

  1. On the Cloud Connections page, choose a connection and hover its name.

  2. Click the name to edit them.

  3. Enter the new Atlassian account email and API token.

  4. Click Save.

Edit credentials

If your credentials have changed or you need to connect as a different user, you can update your cloud connection credentials at any time.

  1. On the Cloud Connections page, choose a connection and hover its credentials.

  2. Click the credentials to edit them.

  3. Enter the new Atlassian account email and API token.

  4. Click Save.

Delete

You can remove unnecessary connections at any time. Use the trash button in the Actions section to delete a connection permanently.

  1. On the Cloud Connections page, choose a connection from the list.

  2. Click the trash button in the Actions column to delete the connection.

  3. Confirm you wish to delete the connection permanently.

  4. Click Delete in the confirmation.