CLI

Tunnels

List, reserve, update, destroy, and open tunnels from the CLI.

On this page

All tunnel operations - from one-off forwarding to managing reserved subdomains.

Commands

tunnee tunnels list                 # list all your tunnels
tunnee tunnels reserve <subdomain>  # reserve a tunnel
tunnee tunnels update <subdomain>   # update a reserved tunnel
tunnee tunnels destroy <subdomain>  # delete a tunnel
tunnee tunnels open                 # open a tunnel and start forwarding
tunnee open                         # shortcut for tunnels open

When to use open

Use tunnee open (or tunnee tunnels open) when you want a live tunnel right now - quick, ephemeral, no management needed.

When to use reserve

Use tunnee tunnels reserve when you want a named tunnel you can update later - stable subdomain, change password or consent settings, keep it around.

List

tunnee tunnels list

Shows all your tunnels in a table: subdomain, status, password, consent, expiry, and close time.

Reserve

tunnee tunnels reserve <subdomain>

Reserves a tunnel by subdomain.

  • --ttl <duration> - paid only, e.g. 24h, 30m
  • --password <value> - paid only, password-protect the tunnel
  • --consent yes|no - paid only, require consent interstitial

On success you get a summary with subdomain, status, expiry, close time, password and consent settings, and creation time.

Update

tunnee tunnels update <subdomain>

Update an existing reserved tunnel. Same --password and --consent flags as reserve.

Destroy

tunnee tunnels destroy <subdomain>

Deletes a reserved tunnel. No confirmation, no flags.

Open

tunnee tunnels open -p 3000

Starts forwarding traffic from a public URL to your local port. Opens an interactive TUI that shows live request logs.

  • -p, --port <number> - local port to forward (required)
  • -s, --subdomain <name> - request a specific subdomain
  • --ttl <duration> - paid only, tunnel lifetime
  • --password <value> - paid only, password protection
  • --no-consent - paid only, skip the consent interstitial

You can also use tunnee open as a shortcut - same thing.

Related docs

Made by Basic Shapes in Europe.