Skip to content
d_devboxby 508.dev/ DocumentationDashboard ↗
Browse documentation
DOCUMENTATION / Private previews

Private development previews

Run your development server on the host, then forward it to laptop loopback. These machines are for development and temporary services, not production hosting.

Forward a known port

TERMINAL
devbox preview 3000 --computer home

The CLI opens a local browser URL after the SSH tunnel is ready. It does not publish the service to the internet. Choose an explicit local port if your workflow needs one:

TERMINAL
devbox preview 3000 --computer home --local-port 43000

Keep the forwarding command running. Stop it with Ctrl+C when finished. Local port conflicts are reported; choose another port rather than stopping an unrelated process.

Discover a service

TERMINAL
devbox services --computer home
devbox preview --computer home

Discovery requires the current host helper, fresh inventory and a listener attributable to an approved workspace. If several match, choose explicitly. A plain SSH host can use an explicit remote port without pretending its inventory is complete.

Development reload and WebSockets

The SSH tunnel transports TCP, including HTTP, SSE and WebSocket traffic used by common development servers. Configure the framework to use the forwarded origin/port if it generates absolute URLs or a different HMR endpoint.

A TCP-forwarding check is not a compatibility guarantee for every Vite/Next configuration. Verify your framework's allowed-host and HMR settings. Do not disable host checks globally just to make a preview load.

Bind privately

Loopback is the default on both ends. Prefer your app listening on host loopback. Forwarding is not an arbitrary proxy into the host's LAN and is not public ingress.

Public sharing requires a separate expiring authorization. The test deployment's browser preview gateway is disabled; a CLI SSH preview is the currently available path.

When connectivity changes

Configured alternate routes can reach the same machine. A tunnel interruption is visible; reconnect before assuming the page is current. Terminal input and commands are not replayed after an ambiguous failure.

Development machines. Your code. Your control.
Private pilot · Feature availability is called out in each guide.