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.