Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page:

Table of Contents
minLevel1
maxLevel6
include
outlinefalse
indent
styledefault
exclude
typelist
class
printabletrue

Prerequisites for creating cloud connections

🔐 Site admin or Оrganization admin permission

You must be a Site or Organization admin in Jira Cloud to create connections to the cloud and migrate projects there. Be aware 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.

🌍 Connectivity to Appfire’s Cloud API and file storage

Your Jira Server or Data Center instance must have access to Appfire resources to connect to the Jira Cloud site.If internet access is restricted, ensure connectivity to ourCloud API and file storage is permitted.

Check the complete list of prerequisites for server-to-cloud Jira migrations in the Prerequisites document.

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 You can create a cloud connection from connection to your destination Jira Cloud site either on the Move to Jira Cloud home page and also or 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.

Note

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 Navigate to the top right of the screen , then and choose Jira Settings > 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 destination Jira Cloud siteURL, 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.
    (warning) 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 let 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.

...

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

...

Rename

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

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

  2. Click the name to edit themit.

  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 timeanytime.

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

  2. Click the credentials to edit themit.

  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 To remove a connection permanently, click Delete (blue star)in the Actionssection to delete a connection permanently column.

  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.