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.34

Last modified on Nov 3, 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$