Skip to main content
smolvm sandbox shell opens an interactive shell inside a sandbox. On recent Linux images it uses the SmolVM guest agent for fast terminal access; when that is unavailable, use smolvm sandbox ssh for a regular SSH session.

Synopsis

smolvm sandbox shell <sandbox> [OPTIONS]

Arguments

sandbox
string
required
Name or ID of the sandbox to connect to.

Options

--boot-timeout
number
default:"30"
Seconds to wait if SmolVM needs to start or resume the sandbox before connecting.

Examples

Open a shell

smolvm sandbox shell my-sandbox

Create and connect

smolvm sandbox create --name dev-env --os ubuntu
smolvm sandbox shell dev-env

Allow more startup time

smolvm sandbox shell dev-env --boot-timeout 60

How it behaves

If the sandbox is stopped or newly created, SmolVM starts it first. If the sandbox is paused, SmolVM resumes it. If the guest agent supports terminal access, the shell opens over the guest-agent terminal stream. Use smolvm sandbox ssh when you need SSH-specific behavior such as a custom user, custom key, or SSH tooling.
Last modified on June 24, 2026