Skip to main content
smolvm sandbox ssh opens an interactive SSH session to a sandbox. Use it when you need SSH-specific behavior, such as SSH agent forwarding, a custom key, or a user account other than root.

Synopsis

Arguments

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

Options

string
Path to the SSH private key.
string
default:"root"
SSH user inside the sandbox.
number
default:"30"
Seconds to wait if SmolVM needs to start the sandbox before connecting.

Examples

Connect to a sandbox

Use a custom key

Connect as another user

Shell versus SSH

Use smolvm sandbox shell for the fastest interactive shell on recent Linux images. It uses the SmolVM guest agent when available. Use smolvm sandbox ssh when you specifically need SSH.
Last modified on June 24, 2026