Skip to content

sandboxes: document opt-in SSH agent forwarding - #25901

Draft
ilopezluna wants to merge 1 commit into
docker:mainfrom
ilopezluna:sandboxes-ssh-agent-opt-in
Draft

sandboxes: document opt-in SSH agent forwarding#25901
ilopezluna wants to merge 1 commit into
docker:mainfrom
ilopezluna:sandboxes-ssh-agent-opt-in

Conversation

@ilopezluna

Copy link
Copy Markdown
Contributor

Description

Updates the Docker Sandboxes docs for the SSH agent forwarding change in
docker/sandboxes#5045: forwarding is disabled by default and requires
explicit opt-in with ssh.agentForwardingEnabled. When enabled, each
sandbox uses the SSH_AUTH_SOCK supplied by the client on create, start,
or join, and ssh.agentSocketPath remains available as an optional fixed
override (for example, the 1Password agent socket).

Changes:

  • security/credentials.md — rewrote the SSH agent section: opt-in
    setting, dynamic per-client socket behavior, and the fixed socket path
    override.
  • workflows.md — added enabling forwarding as the first step of
    Commit signing.
  • troubleshooting.md — added the disabled-by-default check to
    Sandbox commits aren't signed.

The sbx setup and CLI reference changes ship through the vendored
data/sbx_cli/ files on the next vendor sync, so they aren't touched here.

Note: the feature is merged upstream but not yet in a stable release
(lands after v0.39.0). Hold merging until the release ships.

Related issues or tickets

  • docker/sandboxes#5045

Reviews

  • Technical review
  • Editorial review
  • Product review

🤖 Generated with Claude Code

@netlify

netlify Bot commented Aug 20, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 22b1c53
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a87057da414a20008471480
😎 Deploy Preview https://deploy-preview-25901--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.

SSH agent forwarding is no longer inherited implicitly from the daemon's
environment. It requires explicit opt-in via ssh.agentForwardingEnabled,
and each sandbox uses the client's SSH_AUTH_SOCK on create, start, or
join, with ssh.agentSocketPath as an optional fixed override.

Follows docker/sandboxes#5045.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ilopezluna
ilopezluna force-pushed the sandboxes-ssh-agent-opt-in branch from 056cb31 to 22b1c53 Compare August 20, 2026 13:47
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.

1 participant