• Products
  • Documentation
  • Resources

Troubleshoot application tunnels

Here’s some troubleshooting information for application tunnels.

Enable extra logging in your self-managed instance

If you can’t find the solution on this page, set the log level for the com.atlassian.tunnel to TRACE and look for references for the key classes:

  • TunnelConnectionService

  • InletsClientManager

  • TunnelClientProcessStateManager

  • InletsClientProcessFactory

For more info on how to enable logging for different products, see:

Common problems

You might encounter the following issues:



Status is Unavailable in the self-managed instance

The tunnel client (Marketplace app) can’t connect to the tunnel server in Atlassian Cloud. You need to enable logging to identify the cause.

Status is Error in the self-managed instance

The tunnel client was able to reach the tunnel server, but it can’t validate the security key. Make sure the key you added is correct. You can also regenerate the key, or delete the tunnel and create a new one.

Status remains in Connecting in the self-managed instance

At least one of the nodes hasn’t connected to the tunnel. You can try the following solutions:

  • In your self-managed instance, go to Administration > Clustering and check the status of your nodes to make sure they’re up and running.

  • Enable logging to get more information

Status is Connected, but there’s no response after creating application links

Try the following actions:

  • Make sure you used the right application tunnel for your application link.

  • Make sure you have completed the required configuration steps that include adding a HTTP connector and upstream port.

  • Make sure the base URL of your self-managed instance is correct.

Additional Help