Import monitors

To add more than a handful of servers, click Add monitor on the Monitors page, then Bulk import, and add them all at once, either by pasting configs for AI to sort or by uploading config files.

Paste and let AI sort it

The Paste tab is AI-assisted. Paste whatever you have, whether that’s clean share links, full config files, or a block of text copied from an email, and TunnelHQ works out which entries are monitors.

1. Paste your configs.

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

2. Click Analyze with AI.

   TunnelHQ detects the protocol of each entry and extracts its host, port, and settings.

3. Review the detected monitors.

   Each row in the preview is marked ready, needs input, or invalid. Entries missing a credential, such as an OpenVPN password, are marked so you can fill them in before importing.

4. Import.

   Click Import N monitors. Only rows marked ready are imported, and each one’s first check is queued.

Messy input is fine

Duplicate lines, surrounding text, and mixed protocols are expected. The AI step extracts the monitors and ignores everything else.

Upload config files

The Files tab accepts OpenVPN (.ovpn) and WireGuard (.conf, .wg) config files. Drag them onto the drop zone, or click it to browse.

Protocol	File types
OpenVPN	.ovpn
WireGuard	.conf, .wg

Each file can be up to 1 MB, and you can select several at once. TunnelHQ parses each file, detects the protocol, and extracts the connection details. If a file needs a credential, for example an OpenVPN config without an embedded username and password, you’re asked for it before the import completes.

Other file types are skipped

Only .ovpn, .conf, and .wg files are accepted. Other files, and files that can’t be parsed, are skipped with a message, so nothing is left out silently.

If you switch projects while the Import dialog is open, it closes, so nothing is imported into the wrong project.

Subscription URLs

If your provider gives you a subscription URL, TunnelHQ can add its servers and keep them in sync, so your monitors follow the provider when it rotates endpoints.

Paste the subscription URL into Add monitor. The dialog shows Subscription URL detected and previews the configs behind it. Choose the settings and save; TunnelHQ confirms with “Subscription URL saved. Sync started.”

Setting	Options
Sync interval	Every 5 minutes, 15 minutes, 30 minutes, 1 hour (the default), 2 hours, 6 hours, 12 hours, or 24 hours.
Engine	Auto (Both) (the default) races both engines, so configs such as xhttp get tested by Xray-core. Or choose sing-box or Xray-core.
Timeout (seconds)	How long each config’s test may take. Default 30. It also becomes the timeout of every monitor the subscription creates.
Max workers	How many of the subscription’s configs are tested in parallel. Default 5.

Monitors from a subscription are tested each time it syncs, so their check interval is the sync interval, rather than a schedule of their own.

When you edit an existing subscription, its settings form offers a different list of sync intervals: 5, 10, 15, or 30 minutes, or 1, 2, or 6 hours. A subscription set to 12 or 24 hours shows its interval there as “(custom)”.

Subscription URLs need a paid plan

The Free plan can’t add subscription URLs. Starter includes 3, Pro 10, and Business unlimited.

Which method to use

You have	Use
A few servers	Add monitor, one at a time (see Working with monitors)
A large batch of mixed configs	AI paste
A folder of config files	File upload
A provider link that changes over time	A subscription URL