Skip to content

sandboxes: experimental windows support, link to legacy version #24018

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dvdksn merged 1 commit into from
Jan 26, 2026
+12 −1
Merged

sandboxes: experimental windows support, link to legacy version #24018

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions content/manuals/ai/sandboxes/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,11 @@ You get:
For a comparison between Docker Sandboxes and other approaches to isolating
coding agents, see [Comparison to alternatives](./architecture.md#comparison-to-alternatives).

> [!NOTE]
> MicroVM-based sandboxes require macOS or Windows (experimental). Linux users
> can use legacy container-based sandboxes with
> [Docker Desktop 4.57](/desktop/release-notes/#4570).
## How to use sandboxes

To create and run a sandbox:
Expand Down
1 change: 1 addition & 0 deletions content/manuals/ai/sandboxes/agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,7 @@ See the agent-specific documentation:
- Docker Desktop 4.58 or later
- Platform support:
- macOS with virtualization.framework
- Windows with Hyper-V {{< badge color=violet text=Experimental >}}
- API keys or credentials for your chosen agent

## Next steps
Expand Down
1 change: 1 addition & 0 deletions content/manuals/ai/sandboxes/architecture.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@ Docker capabilities but cannot safely share your Docker daemon.
Sandboxes use your system's native virtualization:

- macOS: virtualization.framework
- Windows: Hyper-V {{< badge color=violet text=Experimental >}}

This provides hypervisor-level isolation between the sandbox and your host.
Unlike containers (which share the host kernel), VMs have separate kernels and
Expand Down
2 changes: 1 addition & 1 deletion content/manuals/ai/sandboxes/get-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ This guide runs Claude Code in an isolated sandbox for the first time.
Before you begin, ensure you have:

- Docker Desktop 4.58 or later
- macOS
- macOS, or Windows {{< badge color=violet text=Experimental >}}
- A Claude API key

## Run your first sandbox
Expand Down
4 changes: 4 additions & 0 deletions content/manuals/ai/sandboxes/migration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,10 @@ Docker Sandboxes now run in lightweight microVMs instead of containers. Each
sandbox has a private Docker daemon, better isolation, and network filtering
policies.

> [!NOTE]
> If you need to use legacy container-based sandboxes, install
> [Docker Desktop 4.57](/desktop/release-notes/#4570).
After upgrading to Docker Desktop 4.58:

- Old sandboxes don't appear in `docker sandbox ls`
Expand Down