bdy sandbox endpoint add

View as Markdown

$bdy sandbox endpoint add|create [options] <identifier>

Add an endpoint. Target server must listen on 0.0.0.0, otherwise it will be unreachable

ARGUMENTS

identifier

Sandbox identifier (required)

OPTIONS

-w, --workspace <domain>

Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE

-p, --project <name>

Project name. Can be set via variable: BUDDY_PROJECT

-n, --name <name>

Endpoint name

-e, --endpoint <endpoint>

[ip:]port

-t, --type <type>

Endpoint type (HTTP, TLS, or TCP) (default: "HTTP")

-r, --ep-region <region>

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

--whitelist <cidrs...>

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

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

-s, --serve <directory>

Serve files from a directory

-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

--circuit-breaker <threshold>

Turn on circuit breaker. Provide decimal value between 0 to 1

-k, --key <key>

Path to a TLS key

--cert <cert>

Path to a TLS PEM certificate

-i, --terminate <at>

Terminate TLS at "target", "agent", "region". By default TLS is terminated at "region"

--help

display help for command

Documentation for bdy v1.22.49

Last modified on May 19, 2026

destroy delete

Examples

## create http endpoint on port 80 (http server must listen on 0.0.0.0)
bdy sb ep create sandbox-identifier -e 80$

## create http server and serve files from sandbox directory
bdy sb ep create sandbox-identifier -s /path/to/dir$

## create tcp endpoint on port 22 with name (tcp server must listen on 0.0.0.0)
bdy sb ep create sandbox-identifier -t TCP -e 22 -n test$