Quick start
Add one real VPN monitor, run a live test, and see your first result. This takes about five minutes and you don't need the API or CLI for any of it.
On this page
Before you start
You'll need a TunnelHQ account and one VPN endpoint to test — a host and port, a config file, or a share link (
vless://, ss://, and friends all work).Add your first monitor
Open Monitors and click Add Monitor
In the dashboard, go to Monitors in the left sidebar and click Add Monitor (top right). On mobile, the same button sits in the header.
Paste a config, or enter the details by hand
The fastest path is to paste a config or share link into the box at the top — TunnelHQ detects the protocol and fills in the fields for you. Prefer to type it in? Expand Or enter manually, choose a protocol, and fill in host, port, and any credentials. Each protocol's exact fields are listed under VPN protocols.
Choose where to test from
By default a monitor tests from Any region — TunnelHQ picks a worker for you. On Pro and up you can add specific regions to confirm the server is reachable from, say, Pakistan and Germany at the same time. See Regions & status.
Set the check interval
Pick how often the monitor runs. The fastest interval available depends on your plan — Free checks every 10 minutes, paid plans go down to 1 minute.
Save
Save the monitor. The first check is queued immediately, so within a few seconds you'll see it flip to healthy or down with a latency reading.
Run an on-demand test
Don't want to wait for the schedule? Open the monitor and hit Run Now, or use Run visible tests on the Monitors page to re-check everything you're currently looking at. On-demand tests don't affect your scheduled checks — they're counted separately against your plan's test quota.
That's it
You have a live monitor. From here, TunnelHQ checks it on your schedule, records every heartbeat, and opens an incident the moment it goes down.