smithers-gateway

name	smithers-gateway
description	Serve the multi-run Gateway RPC/WS control plane for workspace run state; unlike up --serve, this is not tied to one run. `smithers gateway status|stop` manages the workspace's running singleton. Run `smithers gateway --help` for usage details.
requires_bin	smithers
command	smithers gateway

smithers gateway

Serve the multi-run Gateway RPC/WS control plane for workspace run state; unlike up --serve, this is not tied to one run. smithers gateway status|stop manages the workspace's running singleton.

Arguments

Name	Type	Required	Description
action	string	no	Manage the workspace's singleton gateway instead of serving one: status

Options

Flag	Type	Default	Description
--host	string	127.0.0.1	Gateway bind address
--port	number	7331	Preferred gateway port (falls back to an ephemeral port when taken; clients discover the verified URL with gateway status)
--backend	string		Storage behind this workspace Gateway; a boot/deployment choice, not a client run-lookup flag
--authToken	string		Bearer token for HTTP/WS auth (or set SMITHERS_API_KEY); required to bind a non-loopback --host
--mintToken	boolean	false	Mint a random bearer token, require it on every request, and record it only in the 0600 runtime state file
--insecure	boolean	false	Allow binding a non-loopback --host with NO auth (exposes a full-control, unauthenticated control plane — dangerous)
--idleTimeout	number		Exit after this many ms with no clients, in-flight runs, or registered schedules (0 = stay up; autostarted daemons set this automatically). Overridable via SMITHERS_GATEWAY_IDLE_MS.