Skip to content

Commit debfa21

Browse files
ndeloofclaude
andcommitted
sandboxes: fix and mermaid-ify the Docker Engine isolation diagram
The ASCII diagram modeled the agent as an "Agent container" managed by a single host-level "Sandbox Docker engine". That is wrong: each sandbox is a microVM running its own Docker Engine, and the agent runs as root inside the VM alongside that engine — it drives the engine to create containers, it is not a container itself. Redraw as a mermaid flowchart with one engine per sandbox VM, the agent as a sibling of the engine, and the containers it creates nested in the engine. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 8c175f7 commit debfa21

1 file changed

Lines changed: 25 additions & 10 deletions

File tree

content/manuals/ai/sandboxes/security/isolation.md

Lines changed: 25 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -60,16 +60,31 @@ your host. When the agent runs `docker build` or `docker compose up`, those
6060
commands execute against that engine. The agent has no path to your host Docker
6161
daemon.
6262

63-
```plaintext
64-
Host system
65-
├── Host Docker daemon
66-
│ └── Your containers and images
67-
68-
└── Sandbox Docker engine (isolated from host)
69-
├── [VM] Agent container — sandbox 1
70-
│ └── [VM] Containers created by agent
71-
└── [VM] Agent container — sandbox 2
72-
└── [VM] Containers created by agent
63+
Each sandbox VM runs its own Docker Engine. The agent runs as root inside
64+
the VM, alongside that engine — not as a container managed by it — and
65+
drives it to create containers, all within the VM:
66+
67+
```mermaid
68+
flowchart TB
69+
subgraph host["Host system"]
70+
subgraph hostd["Host Docker daemon"]
71+
hc["Your containers and images"]
72+
end
73+
subgraph vm1["Sandbox 1 (microVM)"]
74+
a1["Agent (runs as root)"]
75+
subgraph e1["Sandbox Docker engine"]
76+
c1["Containers created by agent"]
77+
end
78+
a1 -->|"docker build / compose up"| e1
79+
end
80+
subgraph vm2["Sandbox 2 (microVM)"]
81+
a2["Agent (runs as root)"]
82+
subgraph e2["Sandbox Docker engine"]
83+
c2["Containers created by agent"]
84+
end
85+
a2 -->|"docker build / compose up"| e2
86+
end
87+
end
7388
```
7489

7590
## Workspace isolation

0 commit comments

Comments
 (0)