bdy tunnel

$bdy tunnel [options] [command]

Start tunnels to local services and manage the tunnel configuration file

OPTIONS

--context <name>

Connection and scope context: default, git, link or a saved name. Overrides the globally active context for this invocation.

--examples

Show only examples; with this flag --format accepts text, json or jsonl

--verbose

Show REST API requests, responses, timing and retries on stderr

-h, --help

display help for command

AVAILABLE COMMANDS

start

Start the tunnels defined in the configuration file

Create or edit the tunnel configuration file

Start a tunnel that exposes a local HTTP/HTTPS service under a public hostname

Start a tunnel that forwards TCP traffic from a public port to a local address, for non-HTTP services such as SSH, RDP, SIP or game servers

Start a tunnel that forwards TLS traffic on port 443 for a hostname to a local address

Documentation for bdy v1.25.20

Last modified on Oct 14, 2026

Examples

Start http tunnel on port 80
bdy tunnel http 80$

Start http tunnel, whitelist ip and turn on on basic auth
bdy tunnel http https://myhost.com -w 1.1.1.1 -a user:pass$

Start named http tunnel and serve local directory
bdy tunnel http -n name -s /path/to/dir$

Start tls tunnel on port 80
bdy tunnel tls 80$

Start tls tunnel and terminate tls at target
bdy tunnel tls 443 -i target$

Start tcp tunnel on port 22
bdy tunnel tcp 22$

Start named tcp tunnel with whitelist
bdy tunnel tcp 80 -n name -w 1.1.1.1/27$

Add tunnel to config
bdy tunnel config add http name 80$

Start tunnel from config
bdy tunnel start name$