> ## Documentation Index
> Fetch the complete documentation index at: https://celesto.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# celesto sandbox shell

> Open an interactive shell in a sandbox with celesto sandbox shell. It uses the fast guest agent on recent Linux images and starts the sandbox if needed.

`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

```bash theme={null}
celesto 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 Celesto needs to start or resume the sandbox before connecting.

## Examples

### Open a shell

```bash theme={null}
celesto sandbox shell my-sandbox
```

### Create and connect

```bash theme={null}
celesto sandbox create --name dev-env --os ubuntu
celesto sandbox shell dev-env
```

### Allow more startup time

```bash theme={null}
celesto sandbox shell dev-env --boot-timeout 60
```

## 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`](https://celesto.ai/docs/celesto/cli/ssh) when you need SSH-specific behavior such as a custom user, custom key, or SSH tooling.

## Related commands

* [`celesto sandbox ssh`](https://celesto.ai/docs/celesto/cli/ssh) - Open a real SSH session
* [`celesto sandbox create`](https://celesto.ai/docs/celesto/cli/create) - Create a sandbox
* [Control channel](https://celesto.ai/docs/celesto/concepts/control-channel.md) - Learn how guest-agent communication works


## Related topics

- [celesto sandbox ssh](https://celesto.ai/docs/celesto/cli/ssh.md)
- [celesto sandbox create](https://celesto.ai/docs/celesto/cli/create.md)
- [celesto sandbox exec](https://celesto.ai/docs/celesto/cli/exec.md)
- [celesto sandbox logs](https://celesto.ai/docs/celesto/cli/logs.md)
- [celesto sandbox env](https://celesto.ai/docs/celesto/cli/env.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.