Skip to content

Commit 258466b

Browse files
committed
sandboxes: consolidate classic sandboxes to single page
Remove individual subpages (agents, architecture, get-started, network-policies, workflows, templates, migration, troubleshooting) and replace with a single docker-desktop.md page. Update _index.md as a minimal landing page for the section.
1 parent 658a21f commit 258466b

18 files changed

Lines changed: 238 additions & 2664 deletions

content/manuals/ai/sandboxes/_index.md

Lines changed: 5 additions & 97 deletions
Original file line numberDiff line numberDiff line change
@@ -5,103 +5,11 @@ weight: 20
55
params:
66
sidebar:
77
group: AI
8-
badge:
9-
color: violet
10-
text: Experimental
118
---
129

13-
{{< summary-bar feature_name="Docker Sandboxes" >}}
10+
Docker Sandboxes let you run AI coding agents in isolated environments using
11+
the `docker sandbox` command. Sandboxes require Docker Desktop and run agents
12+
in microVMs with private Docker daemons.
1413

15-
Docker Sandboxes lets you run AI coding agents in isolated environments on your
16-
machine. Sandboxes provides a secure way to give agents autonomy without
17-
compromising your system.
18-
19-
## Why use Docker Sandboxes
20-
21-
AI agents need to execute commands, install packages, and test code. Running
22-
them directly on your host machine means they have full access to your files,
23-
processes, and network. Docker Sandboxes isolates agents in microVMs, each with
24-
its own Docker daemon. Agents can spin up test containers and modify their
25-
environment without affecting your host.
26-
27-
You get:
28-
29-
- Agent autonomy without host system risk
30-
- YOLO mode by default - agents work without asking permission
31-
- Private Docker daemon for running test containers
32-
- File sharing between host and sandbox
33-
- Network access control
34-
35-
For a comparison between Docker Sandboxes and other approaches to isolating
36-
coding agents, see [Comparison to alternatives](./architecture.md#comparison-to-alternatives).
37-
38-
> [!NOTE]
39-
> MicroVM-based sandboxes require macOS or Windows (experimental). Linux users
40-
> can use legacy container-based sandboxes with
41-
> [Docker Desktop 4.57](/desktop/release-notes/#4570).
42-
43-
## How to use sandboxes
44-
45-
To create and run a sandbox:
46-
47-
```console
48-
$ cd ~/my-project
49-
$ docker sandbox run claude
50-
```
51-
52-
Replace `claude` with your [preferred agent](./agents/_index.md). This command
53-
creates a sandbox for your workspace (`~/my-project`) and starts the agent. The
54-
agent can now work with your code, install tools, and run containers inside the
55-
isolated sandbox.
56-
57-
## How it works
58-
59-
Sandboxes run in lightweight microVMs with private Docker daemons. Each sandbox
60-
is completely isolated - the agent runs inside the VM and can't access your
61-
host Docker daemon, containers, or files outside the workspace.
62-
63-
Your workspace directory syncs between host and sandbox at the same absolute
64-
path, so file paths in error messages match between environments.
65-
66-
Sandboxes don't appear in `docker ps` on your host because they're VMs, not
67-
containers. Use `docker sandbox ls` to see them.
68-
69-
For technical details on the architecture, isolation model, and networking, see
70-
[Architecture](architecture.md).
71-
72-
### Multiple sandboxes
73-
74-
Create separate sandboxes for different projects:
75-
76-
```console
77-
$ docker sandbox run claude ~/project-a
78-
$ docker sandbox run claude ~/project-b
79-
```
80-
81-
Each sandbox is completely isolated from the others. Sandboxes persist until
82-
you remove them, so installed packages and configuration stay available for
83-
that workspace.
84-
85-
## Supported agents
86-
87-
Docker Sandboxes works with multiple AI coding agents:
88-
89-
- **Claude Code** - Anthropic's coding agent (production-ready)
90-
- **Codex** - OpenAI's Codex agent (in development)
91-
- **Copilot** - GitHub Copilot agent (in development)
92-
- **Gemini** - Google's Gemini agent (in development)
93-
- **OpenCode** - Multi-provider agent with TUI interface (in development)
94-
- **[Docker Agent](/ai/docker-agent/)** - Docker's multi-provider coding agent (in development)
95-
- **Kiro** - Interactive agent with device flow auth (in development)
96-
- **Shell** - Minimal sandbox for manual agent installation
97-
98-
For detailed configuration instructions, see [Supported agents](agents/).
99-
100-
## Get started
101-
102-
Head to the [Get started guide](get-started.md) to run your first sandboxed agent.
103-
104-
## Troubleshooting
105-
106-
See [Troubleshooting](./troubleshooting) for common configuration errors, or
107-
report issues on the [Docker Desktop issue tracker](https://github.com/docker/desktop-feedback).
14+
For setup instructions and usage details, see the
15+
[Docker Desktop sandboxes](docker-desktop.md) page.

content/manuals/ai/sandboxes/agents/_index.md

Lines changed: 0 additions & 84 deletions
This file was deleted.

content/manuals/ai/sandboxes/agents/claude-code.md

Lines changed: 0 additions & 120 deletions
This file was deleted.

0 commit comments

Comments
 (0)