Skip to content

docs: document sbx mount/umount for running sandboxes#25387

Draft
dvdksn wants to merge 3 commits into
docker:mainfrom
dvdksn:docs-sbx-mount-umount
Draft

docs: document sbx mount/umount for running sandboxes#25387
dvdksn wants to merge 3 commits into
docker:mainfrom
dvdksn:docs-sbx-mount-umount

Conversation

@dvdksn

@dvdksn dvdksn commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Documents sbx mount / sbx umount, which expose host paths into an
already-running sandbox at runtime — without stopping or recreating it — using
a docker run -v-style spec (HOST[:CONTAINER_TARGET[:ro|rw]]).

Upstream change: docker/sandboxes#3542

What's added

A new Mounting host paths into a running sandbox section in
content/manuals/ai/sandboxes/usage.md covering:

  • Allowlist-only mounts (HOST), visible under /mnt/host/
  • Bind mounts at an absolute container target (HOST:CONTAINER_TARGET)
  • Read-only mounts (:ro, enforced at the kernel mount layer)
  • Idempotency, the host-path-must-exist rule, and relative-path resolution
  • Filesystem policy enforcement, cross-linked to the governance concepts page
  • Revoking paths with sbx umount (and passing the target back to unbind)

Notes

  • The sbx mount / sbx umount CLI reference pages
    (/reference/cli/sbx/mount/, .../umount/) are generated from the vendored
    data/sbx_cli/ YAML, which is synced from docker/sandboxes at release time.
    They'll appear automatically once the release that ships these commands is
    vendored, so this PR intentionally doesn't hand-add those files or link to
    the not-yet-generated pages.
  • Opened as a draft to land alongside the release that ships the feature.

🤖 Generated with Claude Code

Add a usage section covering sbx mount and sbx umount, which expose host
paths into an already-running sandbox at runtime using a docker run -v
style spec (HOST[:CONTAINER_TARGET[:ro|rw]]).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@netlify

netlify Bot commented Jun 18, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 0eb6604
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a33fa27db1fa200083d6267
😎 Deploy Preview https://deploy-preview-25387--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.

@docker-agent docker-agent left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Assessment: 🟢 APPROVE

The new Mounting host paths into a running sandbox section is clean, well-structured, and consistent with the existing document's terse, direct style. Code examples match the described behavior, the relative link to governance/concepts.md#filesystem-rules resolves correctly (the governance/ directory is a sibling of usage.md), and no hedge words, meta-commentary, or marketing language were found. The section fits the existing document's scope and length without inflating it.

No issues to report.

dvdksn and others added 2 commits June 18, 2026 08:59
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants