connect command attaches an interactive terminal, a remote shell, to a running sandbox. It opens a real shell inside the sandbox over a PTY and streams keystrokes in and the shell output back. Run commands, inspect state and debug as if sitting at the sandbox’s own terminal.
The sandbox must already be running.
connect attaches to an existing sandbox by its ID and does not create one. Disconnecting leaves the sandbox and other sessions untouched.Install the CLI and set the
PPIO_API_KEY and PPIO_DOMAIN environment variables before running these commands. See Install and authenticate.Usage
sbx for sandbox and cn for connect, so ppio sbx cn <sandbox-id> connects as well.
Arguments
Options
Requires a traffic access token for sandbox URLs and prints the token. Alias:
--no-allow-public-traffic.Connect to a sandbox
On connect, the CLI prints the sandbox’s dashboard inspect URL and a confirmation line, then hands the terminal over to the sandbox shell:Output
End the session
Exit the shell as usual, withexit or Ctrl+C. The CLI cleans up the terminal, closes the connection and prints:
Output
Disconnecting only ends the terminal session. It does not stop or kill the sandbox, and it does not disconnect other users connected to the same sandbox.