Prerequisites for detecting and connecting to your instances

Here are all prerequisites for detecting your Cloud and Data Center instances, and connecting to the instances from your network.

Detecting Cloud and Data Center instances

Prerequisites that improve the initial detection of Cloud and Data Center instances.

Verify your domain for more accurate results (optional)

Verifying your domain allows Portfolio insights to better identify and associate instances within your organization's ecosystem, providing a more comprehensive view of your Atlassian portfolio.

To verify your domain, follow these steps:

  1. Go to admin.atlassian.com and select your organization.

  2. Navigate to Domains (found under Directory or Settings, depending on your user management experience).

  3. Select Verify domain and enter your domain name.

  4. Choose a verification method from these four options: HTTPS, DNS TXT, Google Workspace, or Microsoft Entra ID, and select verify domain.

To get more details, read our detailed documentation on domain verification.

Update Cloud Migration Assistants

Update the Cloud Migration assistants to the latest versions.

Cloud Migration Assistants are required to detect your instances based on app links. They’re also required for cloud readiness insights, so it’s useful to update them at this point already.


Connecting to Cloud and Data Center instances

Prerequisites for connecting to your portfolio.

Atlassian Cloud products

No prerequisites. We’ll add detected apps to the list, there’s no need to connect to them.

Atlassian Data Center products

To connect to a Data Center instance:

  • Make sure you have the System Administrator permissions

  • Install the Cloud Companion app:

    1. Go to Administration > Manage apps.

    2. Select Find new apps.

    3. Search for Cloud companion and install it.

  • Allowlist this Atlassian domain on your firewall:

    1. Go to Administration > System > Allowlist.

    2. Add the following domain: https://api.atlassian.com.

    3. Select Update to save your changes. For more details, see Configuring the allowlist.


Next steps

Review detected instances from your portfolio

Still need help?

The Atlassian Community is here for you.