Skip to content

docs: sandbox published ports survive restarts#25386

Draft
dvdksn wants to merge 2 commits into
docker:mainfrom
dvdksn:docs-sbx-port-persist-restarts
Draft

docs: sandbox published ports survive restarts#25386
dvdksn wants to merge 2 commits into
docker:mainfrom
dvdksn:docs-sbx-port-persist-restarts

Conversation

@dvdksn

@dvdksn dvdksn commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Description

Document persistent port publishing.

The "Accessing services in the sandbox" section of the sandboxes usage guide previously stated that published ports are not persistent and must be re-published after a restart. That's no longer true. This PR updates the port-publishing notes to describe the new behavior:

  • Published ports are re-published automatically when the sandbox or the daemon restarts.
  • Explicit host ports are reused; a port published with an OS-assigned (ephemeral) host port gets a fresh host port on each start.
  • If an explicit host port is already in use at restart, the CLI or the dashboard prompts you to choose a different host port or cancel.
  • --unpublish 3000 (sandbox-port-only, no host port) is now accepted and removes every host port mapped to that sandbox port — useful for ephemeral ports whose host number you don't know. The previous note said this form was rejected.

Related issues

  • docker/sandboxes#3614

🤖 Generated with Claude Code

Published ports are now persisted and re-published when a sandbox or the
daemon restarts (docker/sandboxes#3614). Explicit host ports are reused;
OS-assigned host ports get a fresh port on each start. Update the port
publishing notes in the sandboxes usage guide to reflect persistence and
the new wildcard unpublish-by-sandbox-port behavior.

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 1e66664
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a3395a8cab3c80008713a85
😎 Deploy Preview https://deploy-preview-25386--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 changes correctly update the port-publishing behavior documentation to reflect that published ports now persist across sandbox and daemon restarts. The updated content is accurate, clear, and consistent with the existing document style. No high- or medium-severity issues found.

Replace the bulleted 'a few things to keep in mind' list with concise
prose paragraphs and drop the bold-term format.

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