bdy agent tunnel

$bdy agent tunnel [options] [command]

Manage tunnels run by the agent

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

Add the tunnels from the configuration file to the agent

Disable tunneling in the agent

Enable tunneling in the agent

Add an HTTP tunnel run by the agent

List tunnels run by the agent

Remove a tunnel from the agent by ID

Show the status of the agent's tunnels, or of one tunnel by ID

Add a TCP tunnel run by the agent

Add a TLS tunnel run by the agent

Documentation for bdy v1.25.20

Last modified on Oct 14, 2026

Examples

Start http tunnel on port 80
bdy agent tunnel http 80$

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

Start tls tunnel on port 80
bdy agent tunnel tls 80$

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

Start tcp tunnel on port 22
bdy agent tunnel tcp 22$

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

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

Start agent tunnel from config
bdy agent tunnel start name$

List agent tunnels
bdy agent tunnel list$

Return the result as JSON
bdy agent tunnel list --format json$

Get agent tunnel status
bdy agent tunnel status tunnel-id$

Return the result as JSON
bdy agent tunnel status --format json$

Remove agent tunnel
bdy agent tunnel rm tunnel-id$