Skip to content

sandboxes v0.12.0#24102

Open
dvdksn wants to merge 12 commits intodocker:mainfrom
dvdksn:sandboxes-461
Open

sandboxes v0.12.0#24102
dvdksn wants to merge 12 commits intodocker:mainfrom
dvdksn:sandboxes-461

Conversation

@dvdksn
Copy link
Contributor

@dvdksn dvdksn commented Feb 9, 2026

Assorted sandboxes updates for dd 4.61 / sandboxes v0.12.0

@netlify
Copy link

netlify bot commented Feb 9, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit c75e3d6
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/698f374e401e2a0008e134a9
😎 Deploy Preview https://deploy-preview-24102--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Update workspace defaults/behavior and automatic sandbox naming.
Add canonical reference section for default network policy configuration,
including policy mode, blocked CIDRs, and allowed hosts.
Document that credentials are scoped per agent with no fallback
authentication methods.
Add documentation for mounting multiple workspaces to a single sandbox,
with support for read-only mounts
Replace deprecated --load-local-template flag with new --pull-template
@github-actions github-actions bot added area/cli Relates to the CLI client area/tests labels Feb 12, 2026
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
@dvdksn dvdksn changed the title sandboxes 461 sandboxes v0.12.0 Feb 13, 2026
@dvdksn dvdksn added the status/do-not-merge Pull requests that are awaiting some event or decision before they can be merged. label Feb 13, 2026
@dvdksn dvdksn marked this pull request as ready for review February 13, 2026 14:34
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

Found 5 issues in the sandboxes v0.12.0 documentation:

  • 1 medium severity: Grammatical error in cagent.md
  • 1 medium severity: Inconsistent placeholder usage in workflows.md
  • 1 medium severity: Incomplete example in quick start (_index.md)
  • 1 medium severity: Incomplete explanation in gemini.md
  • 1 low severity: Subject-verb agreement in migration.md

All issues are in newly added or modified content.

{{< summary-bar feature_name="Docker Sandboxes" >}}

This guide covers authentication, configuration, and usage of Docker cagent in
a sandboxed environment. [cagent](/ai/cagent/) is Docker's open source coding
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Grammatical error: missing plural

The phrase "supports multiple provider" should be "supports multiple providers" (plural).

Suggested change
a sandboxed environment. [cagent](/ai/cagent/) is Docker's open source coding
agent that supports multiple providers.

Docker Desktop 4.58 introduces microVM-based sandboxes, replacing the previous
container-based implementation. This guide helps you migrate from legacy
sandboxes to the new architecture.
The most recent versions of Docker Desktop creates microVM-based sandboxes,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Subject-verb agreement error

"The most recent versions" (plural) should use "create" (plural verb), not "creates" (singular).

Suggested change
The most recent versions of Docker Desktop creates microVM-based sandboxes,
The most recent versions of Docker Desktop create microVM-based sandboxes,


```console
$ docker sandbox run claude ~/my-project
$ cd ~/my-project
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quick start example could be more actionable

The generic AGENT placeholder makes this example less immediately useful. Consider showing a concrete example that users can copy and run, like:

Suggested change
$ cd ~/my-project
$ cd ~/my-project
$ docker sandbox run claude

You could then add a note like "(Replace claude with your preferred agent)"

```console
$ docker sandbox run AGENT ~/my-project
```

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Inconsistent placeholder usage

This file uses uppercase AGENT as a placeholder, but later examples in the same file use concrete agent names like claude, codex, etc. For consistency and clarity, consider using a concrete example here too:

Suggested change
$ docker sandbox run claude

Gemini is in active development. Known considerations:

- Features may change between Docker Desktop versions
- Proxy authentication is a workaround for CLI limitations
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Incomplete explanation of workaround

"Proxy authentication is a workaround for CLI limitations" doesn't explain what those limitations are. Consider clarifying:

Suggested change
- Proxy authentication is a workaround for CLI limitations
Proxy authentication is a workaround for Gemini CLI's OAuth flow limitations. The CLI's built-in OAuth flow doesn't work well in containerized environments, so the sandbox uses proxy-based authentication with API keys instead.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ai area/cli Relates to the CLI client area/tests status/do-not-merge Pull requests that are awaiting some event or decision before they can be merged.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants