Tunnix is in development and not released yet. Downloads will appear here with the first release.

Validate and troubleshoot

Fixes for the most common problems.

Import errors

  • Check the link is complete and uses a supported format (Add servers).
  • Clash/Mihomo YAML and the legacy VMess Base64-JSON format are not supported.
  • For JSON, the editor shows the line and column of the problem.

Failed to download the subscription

  • Open the URL in a browser to see whether it still works.
  • Some providers need a specific User-Agent, HWID or Age key.
  • If the provider reports a device limit, manage your devices with the provider.

Cannot connect

  • Check expiry and remaining data on the subscription.
  • Run a latency test; try another server or automatic selection.
  • Set the device date and time automatically — REALITY and TLS fail with a wrong clock.
  • Try another network (Wi-Fi ↔ mobile data).
  • Open Xray → diagnostics and read the original error.

Connected but some sites fail

  • Switch to All via VPN to check whether a routing rule is the cause.
  • Update routing data; check DNS or turn FakeDNS off.

Platform issues

  • iPhone, iPad, Mac: if the switch turns off at once, use Delete VPN configuration, then connect again and allow it.
  • Android: allow Tunnix to run without battery restrictions and keep notifications on.
  • Windows/Linux: check the selected network interface still exists.

Still stuck?

Contact support. Never send subscription URLs, keys or backup files.