← Sparkbox docs

HTTPS proxy

Every sandbox has a default hostname under the Sparkbox domain. The edge forwards requests to port 8000 in the VM unless the URL names another port or the route is configured differently.

Start a service

python3 -m http.server 8000 --bind 0.0.0.0

Other ports

Use the desired port in the public URL, for example https://your-box.catnip.sh:5173. Common development HTTPS ports are exposed by the CKS edge. Run sparkbox set-port PORT inside the VM to change the default hostname's target.

Wake on request

A request to a paused sandbox asks Sparkbox to resume it before connecting. Cold starts can therefore make the first request slower than subsequent requests.

Access

Routes are private by default and use the Sparkbox browser session. Run sparkbox make-public or sparkbox make-private inside the VM to change all of its routes together. Make a route public only when the service is intended to be reachable without your account.

WebSockets and streaming

The edge passes through WebSocket upgrades and streaming HTTP responses. Application-level authentication, secrets, and authorization remain the application's responsibility on public routes.