Skip to content

Commit 75c1c0d

Browse files
committed
sbx: remove dind limitation on windows
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
1 parent 850c008 commit 75c1c0d

File tree

2 files changed

+11
-27
lines changed

2 files changed

+11
-27
lines changed

content/manuals/ai/sandboxes/agents/custom-environments.md

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -84,19 +84,17 @@ CLI, and common development tools like Node.js, Python, Go, and Java.
8484
| `opencode` | [OpenCode](https://opencode.ai) |
8585
| `shell` | No agent pre-installed. Use for manual agent setup. |
8686

87-
Each variant also has a `-docker` version (for example,
88-
`claude-code-docker`) that includes a full Docker Engine running inside the
89-
sandbox — no local Docker daemon required. The `-docker` variants are the
90-
defaults used by `sbx run` on macOS and Linux. These variants run in
91-
privileged mode inside the microVM (not on your host), with a dedicated block
92-
volume at `/var/lib/docker`, and `dockerd` starts automatically inside the
93-
sandbox.
94-
95-
The block volume defaults to 50 GB and uses a sparse file, so it only
96-
consumes disk space as Docker writes to it. On Windows, the volume is not
97-
sparse and the full 50 GB is allocated at creation time, which increases
98-
startup time. For this reason, the non-docker variants are the default on
99-
Windows.
87+
Each variant also has a `-docker` version (for example, `claude-code-docker`)
88+
that includes a full Docker Engine running inside the sandbox — no local Docker
89+
daemon required. When you pick a built-in agent without specifying a custom
90+
template, `sbx run` and `sbx create` use the `-docker` template variants by
91+
default.
92+
93+
The agent containers created from the `-docker` templates run in privileged
94+
mode inside the microVM (not on your host), with a dedicated block volume at
95+
`/var/lib/docker`, and `dockerd` starts automatically inside the sandbox. The
96+
block volume defaults to 50 GB and uses a sparse file, so it only consumes disk
97+
space as Docker writes to it.
10098

10199
To override the volume size, set the `DOCKER_SANDBOXES_DOCKER_SIZE`
102100
environment variable to a size string before starting the sandbox:

content/manuals/ai/sandboxes/troubleshooting.md

Lines changed: 0 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -59,20 +59,6 @@ configured to use the forward proxy. See
5959
[Monitoring network activity](security/policy.md#monitoring)
6060
for details.
6161

62-
## Docker not available inside the sandbox on Windows
63-
64-
On Windows, sandboxes use non-docker template variants by default, so `docker`
65-
commands aren't available inside the sandbox. To use Docker inside a sandbox on
66-
Windows, specify a `-docker` template:
67-
68-
```console
69-
$ sbx run --template docker.io/docker/sandbox-templates:claude-code-docker claude
70-
```
71-
72-
The `-docker` variants work on Windows but have slower startup times. See
73-
[Base images](agents/custom-environments.md#base-images) for details and the
74-
full list of templates.
75-
7662
## Docker build export fails with "lchown: operation not permitted"
7763

7864
Running `docker build` with the local exporter (`--output=type=local` or `-o

0 commit comments

Comments
 (0)