Troubleshooting

Import fails

Verify the full subscription URL, subscription expiry and device limit. Get a fresh URL from the provider if needed. Repeated save errors should be reported with the time and diagnostic code; do not post the secret URL publicly.

Windows TUN does not start

Run Qmesh as administrator, approve UAC, close conflicting VPN software and use the complete installed application rather than a copied EXE. Check the diagnostic log for the actual error.

A program bypasses the connection

It may ignore the Windows system proxy. Use TUN and check app, domain and IP rules for direct exceptions. Process rules use the executable name, including helper processes, and require saving and reconnecting.

Internet is not confirmed

Open the site you need, then retry the control check. If nothing works, verify normal connectivity without VPN, try another server and check routing/geodata errors. A control endpoint can be unavailable even when other sites work.

Collect diagnostics

Open Settings → Logs and diagnostics. Record the app version, OS, connection mode, problem time and steps. Review exported data before sharing it privately. Do not include subscription tokens, server credentials, email codes or full configurations.

For billing, expiry, device limits and server outages, contact your provider. For installation or app failures, use the contacts published on the Qmesh website.