> ## 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 stop

> Use celesto sandbox stop to shut down a running sandbox while keeping its record available for later inspection or restart.

`celesto sandbox stop` shuts down a running sandbox and releases its live resources. Use snapshots before stopping when you need to preserve memory state exactly.

## Synopsis

```bash theme={null}
celesto sandbox stop <sandbox> [OPTIONS]
```

## Arguments

**sandbox** `string` *required*

Name or ID of the sandbox to stop.

## Options

**--timeout** `number` (default: 3.0)

Seconds to wait before forcing shutdown.

**--json** `flag`

Print a JSON envelope instead of formatted text.

## Examples

### Stop one sandbox

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

### Stop with a longer graceful window

```bash theme={null}
celesto sandbox stop my-sandbox --timeout 10
```

### Create, use, and stop a sandbox

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

## Related commands

* [`celesto sandbox start`](https://celesto.ai/docs/celesto/cli/overview) - Start a stopped sandbox
* [`celesto sandbox snapshot create`](https://celesto.ai/docs/celesto/cli/snapshot) - Save sandbox state
* [`celesto sandbox delete`](https://celesto.ai/docs/celesto/cli/cleanup) - Delete sandbox resources


## Related topics

- [celesto sandbox delete](https://celesto.ai/docs/celesto/cli/cleanup.md)
- [celesto sandbox port](https://celesto.ai/docs/celesto/cli/port.md)
- [Celesto: secure microVM sandboxes for AI agents](https://celesto.ai/docs/celesto/introduction.md)
- [Disposable macOS environments](https://celesto.ai/docs/celesto/guides/macos-sandboxes.md)
- [Windows sandboxes in Celesto](https://celesto.ai/docs/celesto/guides/windows-guests.md)


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