Create an application tunnel to your self-managed instance

An application tunnel connects your whole organization to a self-managed instance and can be used to forward application links from specific cloud products.

Before you begin

• Make sure you’ve prepared your self-managed instance by completing the steps described in Install application tunnels from Atlassian Marketplace and Configure required connections and upstream ports.

• In admin.atlassian.com, you can create up to 100 tunnels, each going to a different self-managed instance. However, each self-managed instance can receive only one tunnel. You can still link multiple cloud products to this single tunnel.

• You’ll generate a security key for each tunnel. If you’d like to later regenerate it or set up automatic key rotation by using APIs, see Regenerate security key and Set up automatic key rotation.

Create a tunnel from admin.atlassian.com

To create a tunnel from admin.atlassian.com:

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

2. Go to Settings > Application tunnels.

3. Select Create tunnel.

4. Go through the wizard to provide the details of your self-managed instance and generate the security key associated with your tunnel.

5. Add the key to your self-managed instance. You can either choose to be redirected to your instance, or copy the key and give it to the admin of this instance so they can add it manually.

Example

This is how a tunnel looks after being created in admin.atlassian.com. The status is Incomplete until you add the tunnel security key to your self-managed instance:

Add the tunnel’s security key to your self-managed instance

To add the tunnel’s security key:

1. Go to application tunnels:

   • If you were redirected here from cloud, you should already be on the right screen.

   • If you weren’t redirected, go to Administration > Application tunnel, and select Add security key.

2. Paste your security key and follow the steps in the wizard.

Your tunnel is created. Wait until its status changes to Connected. For more info on statuses, see Available statuses for application tunnels.

Example

This is how a sample tunnel looks in your self-managed instance:

Next steps

Your tunnel is ready, but you need to make your cloud products use it by creating a tunneled application link. Go to Create a tunneled application link.