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

# Docker Sandbox

Docker sandbox mode runs your agent in a local container so you can catch runtime issues before publishing.

## Prerequisites

* Docker Desktop or Docker Engine.
* `charmos[runner]` installed.

## Run in Docker

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm run . --input "Hello" --docker
```

With JSON:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm run . --json '{"message": "Hello"}' --docker
```

## Mock OAuth and Skills

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm run . --json '{"message": "Check my calendar"}' --docker --mock-oauth
charm run . --json '{"message": "Use a tool"}' --docker --mock-skills
```

## Why Use It

Docker mode helps catch:

* missing dependencies,
* Linux/runtime differences,
* hardcoded local paths,
* missing environment variables,
* base image and adapter incompatibilities.

## Limits

Local Docker is close to the cloud runtime, but not identical. Always run a staging or Store smoke test before relying on production behavior.