bdy tunnel http

$bdy tunnel http|HTTP [options] [protocol://host:port]

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

ARGUMENTS

protocol://host:port

Target address to redirect traffic to. Host is optional and by default local machine. Port is by default 80 (optional)

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

-r, --region <region>

override default region ("eu", "us", "as")

-w, --whitelist <cidrs...>

Whitelist provided IP CIDRs. Use "*" to allow all

-n, --name <name>

Name of the tunnel

-t, --timeout <seconds>

Enforce connection timeout in seconds

-h, --host <host>

Provide custom HTTP host header

--header <headers...>

Header key:value to add to the request

--response-header <headers...>

Header key:value to add to the response

--useragent <useragent...>

Whitelist browser user-agent by contained text or regular expressions (e.g. /my-user-agent/). By Default all are allowed

-a, --auth <user:pass>

Enforce HTTP basic authorization

-b, --buddy

Enforce HTTP Buddy authorization

-l, --log

Log HTTP requests

-v, --verify

Enforce TLS verify

-2, --http2

Enforce HTTP/2

-c, --compression

Turn on HTTP response compression

--ca <ca>

Path to a TLS PEM CA certificate for TLS auth

--note <note>

Resource note

--agent-note <note>

Note for AI agents operating on this resource; stored as agent_note and meant to be read before acting on the resource

--circuit-breaker <threshold>

Turn on circuit breaker. Provide the failure-rate threshold as a percentage between 0 and 100

-s, --serve <directory>

Serve files from a directory

--token <token>

Token to authorize agent

--format <text|jsonl>

Output format: jsonl, text. JSONL CLI errors: {type:"error",error:{code,message,hint}}, exit 1. Default: text (choices: "text", "jsonl")

--help

display help for command

Documentation for bdy v1.25.34

Last modified on Nov 3, 2026

whitelist tcp

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$