Docs · Tunnels
Tunnels: CLI, troubleshooting and FAQ
Docs homeTunnelsBio linksFile shareNetwork tools
Everything below is already published on the app docs and the tunnels page. Quickstart and pricing stay on the docs home and pricing pages.
CLI options
After install (curl -fsSL https://app.overnight.technology/install.sh | bash), the ot script and frpc (frp v0.61.1) sit in ~/.local/bin. Add that directory to PATH. Log in with the API token from the dashboard, then expose a local port:
ot login --token YOUR_API_TOKEN ot http 3000 --slug demo ot http 3000 --slug demo --basic user:pass ot http 3000 --slug demo --secret your-secret ot http 3000 --slug demo --allow 203.0.113.7,10.0.0.0/8 ot http 4242 --slug hooks --secret a-long-random-string
- token (default) ot http <port> --slug <name> — visitors send header X-OT-Tunnel or open the URL with ?ot=.
- basic --basic user:pass — the browser asks for a username and password.
- own secret --secret … — token mode with a secret you choose instead of a generated one.
- IP allowlist --allow 203.0.113.7,10.0.0.0/8 — only those IPs or CIDRs, and they still need the token or password.
The same options are in the dashboard under Create tunnel. A slug belongs to the account that created it. Running ot http again with the same slug keeps the URL. If you pass no --secret, the existing secret stays. Running without --allow clears the allowlist. Stop the process with Ctrl+C. Settings live in ~/.config/ot-tunnels/.
Troubleshooting
401
Missing or wrong token or password, or the visitor’s IP is not on the allowlist. The request never reaches your machine.
404 unknown tunnel
No tunnel with that slug exists. Create it with ot http first, and check the slug in the URL.
409 slug taken
Another account owns that slug. Pick a different one.
frpc: start proxy error
The tunnel server only lets your account bind slugs it owns. If you see “this slug does not belong to your account”, create it with ot http first. If you see “client too old”, clients installed before 7 November 2026 need the install command again.
429
The daily request limit for your plan is reached. Further requests get 429 until midnight UTC. There is no overage charge. Limits are on the pricing page.
502 or 404 from frp
Auth passed, but ot http is not running or nothing is listening on the local port.
The installer will not run
It supports Linux and macOS on x86_64 and arm64, and needs bash, curl and python3. There is no Windows installer today.
FAQ
Is there a free tunnel plan?
No. Plans start at €9 per month for one tunnel. In return there are no usage credits or overage charges to watch.
How do I sign up and pay?
Request access with your email and the plan you want. Online payment is not switched on yet, so we reply by email and set up your account. Nothing is charged by the form.
Can anyone open my link?
No. Every tunnel needs auth. Requests without the right token or password, or from an IP that is not on your allowlist, get a 401 and never reach your machine.
How do webhooks work if the sender cannot log in?
Use token mode and put the secret in the URL you register, for example on hooks.overnight.technology with ?ot= in the query string. The query string reaches your app unchanged.
Do you store my traffic?
The request log keeps the last 200 requests of metadata (time, method, path, status, IP, browser, bytes). Request and response bodies are not stored. The API is GET https://app.overnight.technology/api/tunnels/<slug>/logs with a bearer API token.
Can I run a game server through it?
No. Tunnels carry HTTP(S) only. For a game server, an overnight.host VPS gives you a public IP and any port you need.
Where does HTTPS end?
On our own server in the EU, with Let’s Encrypt certificates. frpc on your machine keeps an outbound connection to ctrl.overnight.technology:7000, so no inbound ports or router changes are needed. Service checks run every 60 seconds on the status page. We do not publish an uptime guarantee. TCP/UDP tunnels, custom domains, WebSockets and streaming responses are not available today.
Request access Full app docs Tunnels overview Pricing
NOCTIS group
overnight.technology is part of the NOCTIS group. The parent company is noctis.industries. This site sits under overnight.holdings, alongside sibling fronts such as overnight.host and overnight.bet.