Skip to main content

Troubleshooting

Here we tried to collect all possible problems that our users have encountered and describe their solutions. Most problems are related to network issues or user environment.

tip

Many errors and problems may already be solved in the latest version of the client, so before diagnosing or contacting us or the community for help, make sure you have the latest version of the client installed. Instructions for updating are available here.

Self-diagnosis of network availability​

If you get errors when creating a tunnel, run the tuna diagnose command to get diagnostic information, the report will help you better understand where exactly the problem is.

Please wait, testing connectivity...

TLS connectivity:
  Google.com: ok [1.46189625s]
  Yandex.ru: ok [1.246520375s]
  tuna API: ok [1.484186875s]
  tuna NL location: ok [739.467083ms]
  tuna RU location: ok [597.777167ms]
TCP connectivity:
  tuna NL location: ok [75.757708ms]
  tuna RU location: ok [34.079541ms]

Typically, tuna uses port 443 to connect to nodes when creating a tunnel. If the TCP connectivity checks fail, check if there is a firewall that may be restricting connections.

Common errors​

Tunnel already active​

ERRO[09:01:09] Failed to get connection settings: Tunnel already active
  Code: BadRequest
  Request ID: 2008cc71bdf725853748bb91d69c4669, retrying in 1s
ERRO[09:01:10] Failed to get connection settings: Tunnel already active
  Code: BadRequest
  Request ID: 0118213a8f8d341f002ec30ee1499768, retrying in 2s
ERRO[09:01:12] Failed to get connection settings: Tunnel already active
  Code: BadRequest
  Request ID: 608d043eb16376a619b671eb0d33dc0b, retrying in 4s

This error Tunnel already active means that the tunnel already exists, it may have hung, or is running somewhere in the background. The easiest way to solve the problem is to delete the hung tunnel in the tunnel management panel. The problem can occur in cases when a connection was lost and our server could not correctly track this. We are working to ensure that this behavior does not occur in the future.

Tunnel limit reached​

If you see the error Tunnel limit reached, although you know that this is not actually the case, this may also mean that there is a hung active tunnel. As with the previous error, the way to solve the problem is to delete the hung tunnel in the tunnel management panel.

VPN​

A lot of strange behavior occurs when working through VPN or if you frequently connect/disconnect to it. Unfortunately, there is no universal solution here, as everything depends on the specific operating system or VPN client. We can recommend excluding routing to Tuna resources through VPN, if your client allows you to do this. Exclude requests to IP api.tuna.am and nodes.