Skip to main content
Killing a sandbox shuts it down and permanently removes it. A killed sandbox cannot be resumed or reconnected. Kill sandboxes from the SDK or from the CLI.
Install the SDK, or the CLI for ppio commands, and set the PPIO_API_KEY and PPIO_DOMAIN environment variables before running these examples. See Quickstart and Install and authenticate.
Killing a sandbox is irreversible. It releases the resources of the sandbox and deletes its data.

Kill a connected sandbox

Call kill() on the sandbox handle.

Kill by sandbox ID

Use the namespace kill method when only the sandbox ID is at hand. It returns true if the sandbox was found and killed, and false if no sandbox with that ID exists. In the examples, sbx-123 and <sandbox-id> stand for a sandbox ID.

Kill all sandboxes

The CLI can kill every running sandbox at once with -a / --all, optionally filtered by state or metadata.
CLI
boolean
Kill every running sandbox at once.
string
Filter which ones to kill by state.
string
Filter which ones to kill by metadata.
Last modified on November 19, 2026