Skip to content
[bhatti]

bhatti publish

Publish a sandbox port at a public URL.

Synopsis

Section titled “Synopsis”
bhatti publish <sandbox> -p <port> [-a <alias>] [—shell]

Description

Section titled “Description”

Creates a routing rule on the bhatti server: incoming requests to https://<alias>.<proxy-zone> get reverse-proxied to localhost:<port> inside the sandbox.

Aliases. With -a my-app, the URL is https://my-app.<proxy-zone> exactly. Without -a, an alias is generated from the sandbox name with a random suffix (dev-k3m9x2) to prevent URL guessing — useful for ephemeral previews.

Cold sandboxes wake automatically. The first request after a sandbox went cold takes ~50ms longer than usual; subsequent requests are full speed.

No auth. Published URLs are public. Anyone with the URL can reach the port. There’s no per-URL access control — share carefully.

HTTP and WebSocket. Both work through the proxy. WebSocket idle timeout is 10 minutes; HTTP body cap is 50 MB per request.

--shell combo. Pass --shell to also generate a web shell token in the same call. Useful for “send a teammate a preview URL and a debug terminal in one click”.

Without a custom domain configured. If the server isn’t running in domain mode, there’s no <alias>.<zone> URL. The CLI prints a fallback hint:

Publishing requires a custom domain.
  Setup: https://bhatti.sh/docs/managing/custom-domain


In the meantime, use the proxy URL directly:
  http://<api-host>/sandboxes/<id>/proxy/<port>/

The proxy URL works but requires Bearer auth, so it’s developer-only.

Examples

Section titled “Examples”
Terminal window
# Friendly subdomain
bhatti publish dev -p 3000 -a my-app
# Published: https://my-app.bhatti.sh
Terminal window
# Auto-generated alias
bhatti publish dev -p 3000
# Published: https://dev-k3m9x2.bhatti.sh
Terminal window
# Preview URL + browser shell, single call
bhatti publish dev -p 3000 -a demo --shell
# Published: https://demo.bhatti.sh
# Shell:     https://api.bhatti.sh/_shell/<id>#token=...

Options

Section titled “Options”
FlagDefaultDescription
-p, --port <int>(required)Port inside the sandbox to publish.
-a, --alias <string>auto-generatedCustom subdomain alias. Without this, an alias derived from the sandbox name with a random suffix is used.
--shellfalseAlso generate a web shell URL in the same call. The shell URL is printed alongside the published URL.

See Global flags for --url, --token, --json, --timing, --data-dir.

See also

Section titled “See also”