Import monitors

Have more than a handful of servers? Don't add them one at a time. Open Import on the Monitors page and bring them all in at once — by pasting configs and letting AI sort them, or by uploading config files.

On this page

Ask AI about this page

Open in Claude Open in ChatGPT Run with TunnelHQ MCP

Paste and let AI sort it

The Paste tab is AI-assisted. Drop in whatever you have — clean share links, full config files, or a messy block copied out of an email — and TunnelHQ figures out what's a monitor and what isn't.

Paste your configs

Share links (vless://, vmess://, trojan://, ss://, hysteria2://, tuic://), WireGuard/OpenVPN config text, and plain host:port lines all work. Mix and match — one per line or in bulk.

Analyze with AI

Click Analyze with AI. It detects the protocol for each entry, extracts the host, port, and settings, and even recognizes non-VPN checks (HTTP, TCP, PING, DNS) if they turn up in what you pasted.

Review the detected monitors

You get a preview list where each row is flagged ready, needs input, or invalid. Anything missing a credential — an OpenVPN password, say — is marked so you can fill it in before importing.

Import

Confirm the list and import. Every ready monitor is created and its first check is queued.

It's fine if the input is messy

The AI step is built for real-world copy-paste. Duplicate lines, surrounding prose, and mixed protocols are expected — it pulls out the monitors and ignores the rest.

Upload config files

The Files tab takes config files directly. Drag them onto the drop zone or click to browse.

OpenVPN — .ovpn
WireGuard — .conf and .wg

Each file can be up to 1 MB, and you can select several at once. TunnelHQ parses each one, detects the protocol, and pulls out the connection details. Files that need a credential (for example, an OpenVPN config that doesn't embed a username and password) prompt you for it before the import completes.

terminal

# Point the uploader at a folder of configs and import them in one pass —
# .ovpn for OpenVPN, .conf / .wg for WireGuard (1 MB max each).

Other file types are skipped

Only .ovpn, .conf, and .wg are accepted. Anything else is skipped with a note, so nothing imports silently.

Subscription URLs

If your provider hands you a subscription URL, TunnelHQ can pull the servers from it and keep them in sync on a schedule — when the provider rotates endpoints, your monitors follow. Each subscription has its own sync interval and a test engine (Xray, sing-box, or auto-select), so the proxy configs behind the link are tested the same way a real client would use them.

Pick the path that fits

A few servers? Paste-and-detect in Add a monitor. A big batch of mixed configs? AI paste. A folder of files? Upload. A provider link that changes over time? A subscription URL.