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

Synopsis

Arguments

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

Options

number
default:"30"
Seconds to wait if Celesto needs to start or resume the sandbox before connecting.

Examples

Open a shell

Create and connect

Allow more startup time

How it behaves

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