Commit Graph
100 Commits
Author SHA1 Message Date
David Karlsson 646d458eb5 docs: document naming and renaming cloud sandboxes
The sandbox management page did not explain how to rename a sandbox. Add naming guidance and link to the existing launch options.
2026-11-03 13:21:44 +00:00
David Karlsson 47172b3700 Upgrade Hugo to 0.169.0 (#26496)
Pin Docker builds and Netlify previews to Hugo 0.169.0. Replace
deprecated `.Params.summary` lookups with `.RawSummary` in the guide
template.

Validation: the full minified debug build passed with
`--panicOnWarning`, path checks, and unused-template checks, with no
deprecation notices. Dockerfile and template formatting checks, Markdown
post-processing tests, rendered summary/redirect checks, and API output
validation passed.
2026-11-02 09:47:38 +01:00
David Karlsson 1ff6054807 Move admin workflows into Organization manuals (#26493)
Move rollout planning into Organization Setup and ongoing user access
guidance into Organization Manage. Preserve the planning, pilot,
provisioning, and review workflows while linking to canonical feature
procedures. Update navigation and the pilot tutorial, and retain both
guide URLs and all seven chapter redirects.

Validation: scoped rumdl and Vale passed with no alerts; Hugo build and
focused rendered checks passed for redirects, links, retained anchors,
cards, and sidebar order. Full validation reached htmltest but its
container failed with an ARM exec format error.
2026-10-30 14:33:18 +01:00
David Karlsson 6a5bbded16 Consolidate the GitHub Actions introduction in the build manual (#26488)
Move repository credential setup and a complete build-and-push workflow
into the GitHub Actions manual. Skip registry sign-in and publishing for
pull requests, and link to specialist examples for testing, metadata,
attestations, and multi-platform builds.

Remove the standalone guide and redirect `/guides/gha/` to the manual,
preserving existing aliases.

Validation: scoped rumdl and Vale checks, Hugo build, and rendered
workflow YAML, internal links, navigation, catalog removal, and
redirects. GitHub Actions execution was not tested. Some retired heading
fragments have no destination equivalent; three setup headings retain
compatible IDs.
2026-10-29 16:47:14 +01:00
David Karlsson b55fd4373b Mention documentation answers alongside other Docker Skills examples (#26379)
## Description

Mention answering questions using official Docker documentation
alongside the existing Dockerfile and Compose examples in the Docker
Skills introduction. Keep the repository catalog as the place to find
individual skills and their descriptions.

## Related issues or tickets

Complements https://github.com/docker/docs/pull/26378, which advertises
Docker Skills in generated `llms.txt`.

## Reviews

Scoped rumdl and Vale checks pass with no errors, warnings, or
suggestions. `git diff --check` passes.

- [ ] Technical review
- [ ] Editorial review

---------

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-29 09:42:35 +01:00
David Karlsson 7b0deb68d9 Fold Bake guide workflows into the manual (#26477)
Retire the two Bake guides and preserve their useful workflows in the
existing manual: Compose release overrides, grouped tests and lint
checks, artifact exports, and release/debug matrices. Redirect the guide
URLs and update inbound links.

Validation: resolved Bake configurations, runtime examples (including an
expected test failure), amd64/arm64 exports, Hugo rendering, redirects,
headings, and navigation checked. Markdown formatting passed. Scoped
lint reports pre-existing Vale findings only; full validation failed
during vendor extraction because the build ran out of disk space.
Whole-site link checks remain for CI.
2026-10-29 08:09:31 +01:00
David Karlsson a698d3a0e6 docs: explain sandbox lifecycle environment variables (#26403)
## Summary

The lifecycle reference lists host command environment variables without
explaining their values. Replace the list with a table covering file
merge order, path separators, sandbox name overrides, and the empty
workspace value in cloud environments. Clarify that sbx commands run by
cloud lifecycle commands inherit cloud mode and the selected endpoint.

Companion to #26393; this change can merge independently. Verified
against docker/sandboxes release/v0.49 at c5b19951af12. Scoped rumdl and
Vale checks passed.

@netlify /ai/sandboxes/configuration/environment-files/

Generated by Codex
2026-10-28 08:22:20 +01:00
David Karlsson 1bdc168e07 Clarify registry credential use in Sandboxes (#26450)
Update the host-only registry credential description to refer to `sbx`
as a whole, covering pulls authenticated by the daemon. The credential
storage commands and scope guidance are unchanged.

Validation: Markdown formatting and scoped rumdl/Vale checks passed.
2026-10-28 08:21:26 +01:00
David Karlsson e09850d383 docs: align Agentic Platform guidance with the Console (#26422)
The Agentic Platform docs referenced outdated Secrets controls and
omitted steps needed to configure MCP clients, network rules, and SSH
access. This updates the navigation and task guidance from the October
23 UI audit, including sandbox restore actions, kit filters, naming and
compute selection, and delayed usage reporting.

Each of the 11 audit findings has a separate commit. Feature
availability is qualified where it varies by account. Signup
requirements and pause/process semantics remain unchanged; process
restoration still needs product confirmation.

All seven changed Markdown files passed rumdl and Vale with no errors,
warnings, or suggestions.

@netlify /agentic-platform/

Generated by Codex
2026-10-27 18:02:17 +01:00
David Karlsson b2095f2e9e docs: clarify Sandboxes first-run policy setup (#26421)
## Summary

The getting-started walkthrough promised a network preset prompt on the
first sandbox run, even when policy was already configured. Explain when
the CLI prompts, document `sbx policy init balanced` for manual
initialization, and remove outdated prompt transcripts from the
walkthrough and local-policy page. Also clarify that agent kits can add
model-provider allowances under Locked Down.

@netlify /ai/sandboxes/get-started/

Generated by Codex
2026-10-27 17:59:10 +01:00
David Karlsson f55dc7b65b sbx: link to sandbox vs containers page from tutorial (#26464) 2026-10-27 17:50:59 +01:00
David Karlsson 55518f1168 build: update Go to 1.27 (#26451)
Update `GO_VERSION` from 1.26 to 1.27 in the root and releaser
Dockerfiles. Keep the floating minor-version image tags used in
6a093939d4 and da3893027f; both 1.27 tags resolve to Go 1.27.3 on
October 26, 2026. Unlike those broader updates, this PR leaves module
files and the Go version used in documentation examples unchanged.

Docker Agent v1.151.0 and later require Go 1.27. The official Go image
sets `GOTOOLCHAIN=local`, so the Go 1.26 build cannot vendor those
releases. Daily `sync-docker-agent-docs` runs have failed since at least
October 24, 2026; the [October 26
run](https://github.com/docker/docs/actions/runs/40261071727) reports
this version mismatch while vendoring v1.152.0.

#26368 will be stacked on this PR to sync Docker Agent v1.152.0 and fix
the Community links. Merge this toolchain upgrade first.

Validation: `dockerfile-lint`, `releaser-build`, `releaser-test` (9
tests), and `validate-api-reference` passed with `docker buildx bake`.
Local `validate-vendor` and `test` hit the existing Community vendor
mismatch and nine missing references from the separately applied #26368
changes. CI on this isolated two-line PR is the authoritative check for
those targets.
2026-10-27 09:14:47 +01:00
David Karlsson c572cdcb54 docs: cover sbx 0.50 user-facing changes (#26449)
Documents six user-facing changes in sbx 0.50: kit host mount bindings,
persistent kit volume retention, environment MCP command approvals and
ownership, HTTP query restrictions, cloud sandbox inspection, and exec
exit status in automation. Each change has its own commit. Also vendors
the matching v0.50 CLI reference verbatim and regenerates the release
notes from published GitHub releases.

Kit documentation focuses on sbx usage and links to the canonical
capability definitions. Volume retention follows the 0.50
implementation; the upstream spec's main branch describes a different
storage lifecycle.

Verified against the release implementation. Scoped Markdown and prose
lint, a full Hugo build, and checks of the added internal links pass.

Related release: https://github.com/docker/sandboxes/issues/7698

Generated by Codex
2026-10-26 17:28:15 +01:00
David Karlsson 4c58b5e696 docs: clarify sandbox checkout and parallel task workflows (#26408)
## Summary

The Git workflow guide omitted mountless repositories and suggested that
separate branches were enough to isolate simultaneous tasks. Add a
mountless workflow, compare where changes appear, clarify Git access in
direct mode, and align the workflows overview and Claude Code guidance
on using separate working directories.

Markdown and Vale checks pass for all three changed pages.

@netlify /ai/sandboxes/workflows/git/

Generated by Codex
2026-10-22 15:26:02 +02:00
David Karlsson 5179c97252 docs: build and preview an app in the DAP Shell quickstart (#26413)
## Description

Make the first Docker Agentic Platform session useful without a model
provider API key: launch the Shell kit, clone the Welcome to Docker
sample, build its container image, run the app, and preview it through
the Console's port connection. Readers can continue editing the same
project in VS Code or Cursor over SSH.

PReview:
https://deploy-preview-26413--docsdocker.netlify.app/agentic-platform/get-started/
2026-10-22 14:52:32 +02:00
David Karlsson 6bc39c45a1 docs: make cloud environment files a practical workflow (#26393)
## Summary

The cloud environment example didn't show how to work on a project, and
readers had to reach later subsections to discover the differences from
local sandboxes. Move the walkthrough into the cloud section, explain
those differences upfront, and show how to create an environment, copy
in a project, work with Claude Code, retrieve changes, and clean up.

Cover cloud credentials, expiration, unsupported settings, and reuse
limitations. Preserve the original entry anchor and update cloud
cross-references. Behavior checked against docker/sandboxes
release/v0.49 at c5b19951af12; scoped Markdown and Vale checks, Hugo
build, and rendered internal link checks passed. No live cloud session
was run.

@netlify /ai/sandboxes/cloud/environment-files/

Generated by Codex
2026-10-22 12:15:36 +02:00
David Karlsson fce2734a08 docs: clarify how kits and environment files work together (#26405)
Environment files were introduced mainly as an alternative to publishing
a kit set, leaving their broader role unclear. Explain near the top of
both pages how kits package software and its requirements while
environment files capture sandbox configuration, add reciprocal links,
and shorten the kit-set comparison.

Scoped rumdl and Vale checks pass for both changed pages.

@netlify /ai/sandboxes/customize/

Generated by Codex
2026-10-22 12:15:15 +02:00
David Karlsson ebdeb7a38c Merge pull request #24794 from Nedunchezhiyan-M/fix/style-meta-commentary-engine
engine: remove Vale-flagged meta-commentary in storage driver docs
2026-10-21 15:47:15 +02:00
David Karlsson 8ee67d493e Merge pull request #24793 from Nedunchezhiyan-M/fix/style-hedge-words-build-manuals
build: remove hedge words "simply" and "easily" in build manuals
2026-10-21 15:44:55 +02:00
David Karlsson 4e8f36a5dc Merge pull request #24783 from Nedunchezhiyan-M/fix/engine-lets-you-grammar
docs: fix spurious 'to' and double slash URL in two files
2026-10-21 15:41:27 +02:00
David Karlsson 1f662b3a53 Merge pull request #24778 from Nedunchezhiyan-M/fix/build-exporter-missing-space
build: add missing space after comma in exporters table
2026-10-21 15:40:01 +02:00
David Karlsson f29f36ba49 Merge pull request #24781 from Nedunchezhiyan-M/fix/engine-proxy-semicolon
engine: fix punctuation in proxy configuration guide
2026-10-21 15:39:29 +02:00
David Karlsson a7b78fcb21 Merge pull request #24782 from Nedunchezhiyan-M/fix/engine-btrfs-double-negative
engine: clarify btrfs volumes drawback note by removing double negative
2026-10-21 15:39:05 +02:00
David Karlsson 320432c1e5 Merge pull request #24779 from Nedunchezhiyan-M/fix/engine-runmetrics-sentence
engine: add missing colon in runmetrics docker stats example
2026-10-21 15:38:13 +02:00
David Karlsson dea74bd1f0 Merge pull request #26407 from dvdksn/emudhra-sec-announcement
docs: explain Sandboxes response to eMudhra CA compromise
2026-10-21 14:57:26 +02:00
David Karlsson ace4411f47 docs: explain Sandboxes response to eMudhra CA compromise
Cached template images and existing sandboxes need updates after the external eMudhra certificate authority compromise. Add guidance for recreating sandboxes with refreshed images or updating CA certificates in place.
2026-10-21 12:52:37 +00:00
David Karlsson b13b788279 Merge pull request #24773 from Nedunchezhiyan-M/fix/bake-intro-grammar
build: fix relative clause grammar in Bake introduction
2026-10-21 14:21:17 +02:00
David Karlsson 6529f36d3c Merge pull request #24766 from Nedunchezhiyan-M/fix/build-git-auth-token-ci-job-token-note
build: note that GIT_AUTH_TOKEN is incompatible with GitLab CI_JOB_TOKEN
2026-10-21 14:18:21 +02:00
David Karlsson 660f0b3d74 Merge pull request #24775 from Nedunchezhiyan-M/fix/build-context-prose-errors
build: fix prose errors in build context documentation
2026-10-21 14:17:23 +02:00
David Karlsson 6a06d3ec7a docs: update Sandboxes documentation for v0.49.1 (#26387)
Update Sandboxes documentation for current kit validation and signing
behavior, host Git-ignore snapshots, cloud proxy support, and browser
and daemon logging settings. Correct SSH workspace, policy refresh,
automation, environment merging, and T3 toolchain guidance.

Keep offline checks alongside kit validation and inspection, consolidate
proxy explanations, and make toolchain installation conditional.
Preserve the upstream explanation of kit context files.

Regenerate the published v0.49.1 release notes and vendor the CLI YAML
from docker/sandboxes release/v0.49.

Each atomic change has its own commit. Rebased onto main. Scoped
Markdown and Vale checks, the Hugo build, and diff whitespace checks
passed. All 121 CLI YAML files parse and match upstream exactly.

Generated by Codex
2026-10-21 13:20:55 +02:00
David Karlsson a1e520f672 docs: vendor Sandboxes v0.49 CLI reference
Copy docs/yml/*.yaml from docker/sandboxes release/v0.49 at c5b19951af121b439800029695f88bf1139a0b0b into data/sbx_cli without local edits.
2026-10-21 11:09:53 +00:00
David Karlsson e1fe509582 docs: regenerate Sandboxes release notes for v0.49.1
Import the published stable release with hack/sbx-release-notes.py, retaining the latest three minor releases.
2026-10-21 11:09:53 +00:00
David Karlsson d179d4fdb5 docs: update native build toolchain guidance
Full template contents and T3 prerequisites did not reflect the included C/C++ toolchain. Document the tools and make manual installation conditional on missing dependencies.
2026-10-21 11:09:53 +00:00
David Karlsson 6d661ebaa5 docs: explain validation before merging environment files
Environment merging guidance could imply a later override repairs invalid input. Explain that every source file, including user defaults, must be valid before merging.
2026-10-21 11:09:43 +00:00
David Karlsson 50e440cb34 docs: document daemon log rotation settings
The settings reference lacked daemon log retention controls. Document rotation size, backup count, age limits, defaults, and restart requirements.
2026-10-21 11:09:42 +00:00
David Karlsson 84c39d8663 docs: document the host browser access setting
The settings reference lacked the host browser access control. Document its default, configuration command, and effect on in-sandbox OAuth logins.
2026-10-21 11:09:42 +00:00
David Karlsson 6a0d754624 docs: document quiet listings for automation
The automation guide did not identify quiet output for policies, settings, or approvals. List the returned identifiers and distinguish cloud policy output.
2026-10-21 11:09:42 +00:00
David Karlsson d4dee0f031 docs: explain missing-secret failures in cleanup scripts
Automation guidance did not cover secret removals that match no stored entry. Explain the nonzero result and checking for matching secrets before cleanup.
2026-10-21 11:09:42 +00:00
David Karlsson 63b70a9b36 docs: document cloud connections through upstream proxies
Proxy guidance excluded host connections to cloud sandboxes. Document their proxy scope and the direct cloud SSH setting, and link the cloud SSH workflow to that guidance.
2026-10-21 11:09:42 +00:00
David Karlsson 114c744d24 docs: use policy refresh for stale governance rules
Monitoring guidance recommended resetting policy to fetch changes. Use the refresh command and explain how it affects new and existing connections.
2026-10-21 11:09:42 +00:00
David Karlsson e57dbfef9e docs: explain host Git ignore snapshots
Git workflows did not explain how host ignore decisions reach local sandboxes. Document the creation-time snapshot and its limits without implying that ignored files are inaccessible.
2026-10-21 11:09:42 +00:00
David Karlsson a336f47dd5 docs: correct the initial SSH workspace directory
The integration guide suggested SSH shells might start outside the primary workspace. State that interactive SSH starts in the sandbox workspace while editor folder pickers can choose another location.
2026-10-21 11:09:41 +00:00
David Karlsson 0c951c0ea9 docs: explain Git transformations when signing kits
The signing instructions did not account for Git changing signed file contents. Explain the signing warning and why local verification does not establish that committed bytes match.
2026-10-21 11:09:41 +00:00
David Karlsson d0e44568ec docs: explain offline kit checks
Kit authors lacked guidance for checking local sources without a daemon or sign-in. Document offline validation and inspection, including the policy checks they skip.
2026-10-21 11:09:38 +00:00
David Karlsson 153107fe61 Merge pull request #26401 from miparnisari/fix-latest
chore: fix random things in latest.yaml
2026-10-21 08:59:25 +02:00
David Karlsson eeee4e20be Merge pull request #26392 from dvdksn/fix-null-lastmod
fix: omit zero lastmod dates from sitemap
2026-10-20 17:10:34 +02:00
David Karlsson a84ff95425 Advertise Docker Skills in llms.txt (#26378)
## Description

Add Docker Skills to the discovery links near the top of generated
`llms.txt`, and point the MCP link to
`https://ai-backend-service.docker.com/mcp` for direct access to the
Docker RAG server.

Changes the Hugo template only; the generated file is not checked in.

## Reviews

Verified the skills page returns HTTP 200 and the MCP endpoint
initializes as `gordon-rag`. Rendered the updated template with Hugo in
a minimal site and confirmed both discovery links appear in the
generated header. `git diff --check` passes. A full docs-site build was
not run.

- [ ] Technical review
- [ ] Editorial review

---------

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-20 17:10:16 +02:00
David Karlsson 791931b1ac skills: assess documentation impact and fit before adding content (#26388)
Documentation updates can be technically accurate yet unnecessary,
duplicated, or poorly placed. Update research to justify an edit through
the reader's task and a specific documentation gap, write to integrate
it into the existing page, and review-changes to assess reader value,
placement, and flow.

Keep the guidance in the existing skills, without a required reporting
template. Each skill update has its own commit.

Markdown checks pass; Vale reports only pre-existing findings outside
the edited lines. Skill validation passes after excluding unchanged
Claude-specific metadata unsupported by the Codex validator.

Generated by Codex
2026-10-20 17:09:34 +02:00
David Karlsson d6df16b222 fix: omit zero lastmod dates from sitemap
Generated reference pages without modification dates appeared in the sitemap with lastmod set to 0001-01-01. Only render lastmod when the page has a nonzero date.
2026-10-20 14:36:06 +00:00
David Karlsson 95b8ec69e3 docs: clarify custom secret injection is limited to headers (#26377)
## Summary

Custom secret injection is limited to HTTP request headers, but the
credentials page recommended it for secrets in request bodies and
described replacement anywhere in a request. Remove that use case and
clarify the header-only restriction.

@netlify /ai/sandboxes/configuration/credentials/

Generated by Codex
2026-10-20 09:20:48 +02:00
David Karlsson 84602ad93d docs: clarify where kit context files live (#26380)
## Description

Explain how the generated Kits section points agents to each kit's
guidance, including packaged context files under
`/usr/share/sandbox/kit/<stem>/` and the location of inline
instructions.

@netlify /ai/sandboxes/customize/use-kits/

Generated by Codex
2026-10-20 09:20:30 +02:00
David Karlsson 257d2217fd Point llms.txt to the Docker RAG MCP endpoint
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-19 14:58:29 +00:00
David Karlsson 5cb209a1d4 Advertise Docker Skills in llms.txt discovery links
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-19 08:51:49 +00:00
David Karlsson 5a5401f376 chore: generate sbx v0.48.0 release notes (#26366)
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-16 11:32:05 +02:00
David Karlsson bb744f7745 docs: document unloading MCP servers from sandboxes (#26289)
Document `sbx mcp unload` for removing a server from a running sandbox
without restarting the agent. Explain how to reload it, distinguish
unloading from removing its registration, and describe what happens
after unloading all static servers.

Validation: Markdown and style checks pass.

Generated by Codex.
2026-10-16 10:06:46 +02:00
David Karlsson ab3d738546 docs: clarify the recommended v3 kit workflow (#26344)
## Description

Built-in agent names select v2 kits, while published v3 workloads such
as `sbx/claude` collide with those names. This change recommends v3,
maps built-in agents to published v3 workloads with distinct names, and
shows compatible CLI, kit set, and environment-file examples. The
environment-file guide starts with a built-in v2 agent and links to a
separate v3 workflow.

Compatibility, capability requirements, and migration steps each live on
the page where readers need them.

Scoped Markdown and Vale checks pass. OCI manifests verify the v2
Playwright mixin and the published v3 references; v0.48.0
agent-registration and environment kit-resolution tests pass. A full
sandbox launch was unavailable because Docker sign-in is required in
this workspace.

@netlify /ai/sandboxes/customize/use-kits/

Generated by Codex
2026-10-14 12:25:56 +02:00
David Karlsson 9643ba0813 docs: make DAP getting started a complete first session (#26339)
The Console getting started page ended at sandbox launch. Expand it into
a complete first session: review a public sample project with Claude
Code, inspect and save the result, optionally connect VS Code or Cursor
over SSH, and pause or delete the sandbox.

Preserves the sandbox options reference and existing heading anchors.
The platform overview remains the gateway to concepts; use-case guides
remain separate in #26321.

Formatting, scoped Markdown and Vale lint, Hugo build, and all 19
internal links passed. This remains a draft pending live Console, cloud
SSH, and editor verification.

@netlify /agentic-platform/get-started/

[Preview the
walkthrough](https://deploy-preview-26339--docsdocker.netlify.app/agentic-platform/get-started/)

Generated by Codex
2026-10-13 19:33:14 +02:00
David Karlsson c64e3927ef docs: update Sandboxes for the v0.48.0 CLI refactor (#26314)
## Summary

Update the Sandbox documentation for the v0.48.0 CLI refactor: renamed
flags, settings commands, terminal output, structured output, and
non-interactive confirmations. Add a migration reference for scripts and
CI workflows, with a [**Copy as prompt**
button](https://deploy-preview-26314--docsdocker.netlify.app/ai/sandboxes/workflows/automation/#update-scripts-for-v0480)
that copies agent instructions and the section Markdown.

This PR targets `main` independently of the other PRs in the sbx/v0.48.0
milestone. It keeps the generated reference import separate from
documentation edits:

- Vendor the 120 generated CLI YAML files
- Update command examples and guidance. Historical release notes retain
their original command spellings.

The other milestone PRs cover separate release features; this PR covers
the CLI migration.

@netlify /ai/sandboxes/workflows/automation/

Generated by Codex
2026-10-13 17:18:50 +02:00
David Karlsson 115d2302b8 docs(sbx): fill gaps in sandbox feature guides (#26320)
Several sandbox feature guides omit supported tasks or describe them
inaccurately. This change fills those gaps in the documentation for
released Sandboxes v0.47.0 and organizes the additions around the tasks
readers need to complete.

- MCP: document DHI registration after the other server inputs, make
OAuth client changes a focused maintenance task, and place resource
overrides after normal OAuth setup.
- Environment files: consolidate file placement and write protection
after the first setup example, and explain plan output before listing
its symbols.
- Cloud: separate saving and reusing templates, importing local
templates, and customizing with kits. Explain capture modes beside the
relevant operations.
- Skills: correct import precedence, include OpenCode, and explain
skipped linked dependencies after the import command.
- Kits v2: correct the downloaded archive formats in the command entry
and put provenance inspection with signing and verification. Omit OCI
storage details that don't help complete these tasks.

Behavior was checked against the v0.47.0 source. In particular,
replacing an OAuth client secret does not clear its previous identity
binding; the recovery task retains the required reset and tells readers
to verify the intended client and provider first.

Validation: scoped Markdown and Vale lint passed, the full Hugo
development build passed, and checks of the five rendered guides
confirmed complete code blocks, visible placeholders, plan indentation,
valid same-page anchors, skills import order, and the revised task
headings. Changes are committed separately by issue. The v0.48 migration
remains in #26314.

```release-note
NONE
```

---------

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-13 16:04:21 +02:00
David Karlsson 2e7b8fc101 docs: document startup hooks added to existing sandboxes (#26290)
## Summary

The v2 kit reference says that adding a kit with startup commands
requires removing and recreating the sandbox. Document support for
startup commands through `sbx kit add` and explain when they run.

Implementation:
[docker/sandboxes#6886](https://github.com/docker/sandboxes/pull/6886).
Checked against the `release/v0.48` source and its regression coverage.
Changed Markdown passes rumdl and Vale.

For [Sandboxes
v0.48.0](https://github.com/docker/sandboxes/issues/7014); kept in draft
for the upcoming release.

@netlify /ai/sandboxes/customize/kits-v2/

Generated by Codex
2026-10-13 15:59:48 +02:00
David Karlsson d069744d73 docs: add a kit capability support reference (#26299)
Add a kit capability support reference showing local and cloud
availability, minimum `sbx` versions, capability-group behavior, and
restrictions on `sbx kit add`. Link it from the authoring overview and
clarify that v3 kits must request SSH-agent forwarding. Keep capability
definitions and examples in the upstream specification.

Validation: Markdown and style checks pass; upstream capability links
verified.

Generated by Codex.
2026-10-13 15:12:03 +02:00
David Karlsson 3673f3c3db docs: document Windows SSH agent selection (#26295)
Document the Windows SSH-agent fallback under `ssh.agentSocketPath`,
including what happens when both the setting and `SSH_AUTH_SOCK` are
unset. Keep the general SSH-agent guide focused on setup and linked to
the settings reference.

Validation: Markdown and style checks pass.

Generated by Codex.
2026-10-13 15:11:35 +02:00
David Karlsson 734ce2eeb8 docs: document thinking variants for sandbox models (#26292)
Document how to select a model reasoning level with `sbx run --variant`,
with an example and the relevant agent limitations.

Validation: Markdown and style checks pass.

Generated by Codex.
2026-10-13 15:11:14 +02:00
David Karlsson 89f0a32182 docs: document managed desktop sandbox connections (#26288)
Document desktop app connections that create a sandbox on first use and
reuse it on later connections. Keep the shared setup and lifecycle
behavior on the integrations overview, with brief links from the ChatGPT
and Claude Desktop pages.

Validation: Markdown and style checks pass.

Generated by Codex.
2026-10-13 15:10:46 +02:00
David Karlsson f79b4db0a0 docs: use stored provider secrets for sandbox model selection (#26291)
Document using stored API keys for hosted and custom model providers.
Explain how the host proxy supplies the key to the model service and
make clear that selecting a provider does not restrict the key to that
provider's endpoint. Clarify the environment-variable fallback.

Validation: Markdown and style checks pass.

Generated by Codex.
2026-10-13 15:10:07 +02:00
David Karlsson 17d2ec7d24 docs: document cloud timeout settings for moves and environments (#26293)
Document expiration settings for cloud moves and environments, including
automatic restart at expiration. Organize the cloud environment guidance
into task sections covering setup, supported settings, expiration,
credentials, reuse, removal, and recovery.

Validation: Markdown and style checks pass.

Generated by Codex.
2026-10-13 15:09:55 +02:00
David Karlsson 44860d431d docs: document agent identity for kit hooks and scripts (#26296)
## Summary

Kit authors can use `SBX_AGENT` to choose setup behavior for the
provisioned agent. Document the value for built-in and custom agents,
and how install hooks request the variable.

Implementation:
[docker/sandboxes#6876](https://github.com/docker/sandboxes/pull/6876).
Checked against the `release/v0.48` source and its regression coverage.
Changed Markdown passes rumdl and Vale.

For [Sandboxes
v0.48.0](https://github.com/docker/sandboxes/issues/7014); kept in draft
for the upcoming release.

@netlify
/ai/sandboxes/customize/author/#pass-environment-variables-to-hooks

Generated by Codex
2026-10-13 15:09:17 +02:00
David Karlsson f1bef37345 docs: explain the not responding sandbox status (#26301)
## Summary

Explain the `running (not responding)` status shown by `sbx ls` and how
to restart the affected sandbox while keeping saved files.

The status was introduced in
[docker/sandboxes#6111](https://github.com/docker/sandboxes/pull/6111).
[docker/sandboxes#6778](https://github.com/docker/sandboxes/pull/6778)
extends detection to command execution and file transfer. The entry
documents the visible status and recovery without diagnosing the
underlying failure or implying that it is common.

Changed Markdown passes rumdl and Vale. Kept in draft for [Sandboxes
v0.48.0](https://github.com/docker/sandboxes/issues/7014).

@netlify /ai/sandboxes/troubleshooting/#sandbox-is-not-responding

Generated by Codex
2026-10-13 15:08:43 +02:00
David Karlsson 8ac30aaec4 docs: document URL blocking in build steps (#26312)
## Summary

The build policy docs covered HTTP downloads through `ADD` but did not
explain how to block URLs requested by `RUN` steps. Add a tested
allowlist example using `"caps": {"exec.proxy": true}` in the policy
file and update the HTTP input reference, with a brief builder flag
example for CI.

Verified that Debian package downloads pass and the blocked URL returns
HTTP 403 and fails the build. Scoped Markdown and Vale checks passed,
with one existing Vale warning on unchanged text.

@netlify /build/policies/usage/

Generated by Codex
2026-10-13 12:48:09 +02:00
David KarlssonandClaude Sonnet 5.5 aa3d2b22d9 chore: remove stale docker-agent configs and Copilot prompts (#26313)
## Summary

Removes files left over from earlier agent tooling that nothing
references anymore, and moves the `curate-whats-new` examples next to
the skill that uses them.

- Delete `tech_writer.yml` and `docs_engineer.yml`, unused docker-agent
configs, and the `.validation.log` ignore entry that only they wrote.
- Delete `.github/prompts/`, unreferenced Copilot prompt files that link
to a nonexistent style guide.
- Move `.github/agents/whats-new-examples/` to
`.agents/skills/curate-whats-new/examples/`.

`.github/agents/docs-scanner.yaml` and the `docker-agent-action`
workflows stay, since CI still uses them.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-13 12:47:43 +02:00
David Karlsson 3f5e702096 docs: remove experimental framing from cloud sandboxes (#26335)
## Summary

Remove experimental badges and notices for the Cloud Sandboxes CLI, API,
and SDK, including the API reference card and CLI release notes.
Preserve the Docker Agentic Platform experimental status, the
subscription requirement, and feature-specific experimental warnings.

@netlify /ai/sandboxes/cloud/

Generated by Codex

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-12 16:09:12 +02:00
David Karlsson 63cc3634e3 docs: update Gordon legal terms links (#26319)
## Summary

Gordon's Supplemental Terms are no longer in effect. Replace the
reference under Questions about privacy with a link to the Docker
Subscription Service Agreement.

@netlify /ai/gordon/concepts/data-privacy/

Generated by Codex
2026-10-09 13:31:14 +02:00
David Karlsson da6c1308a0 Merge pull request #26316 from dvdksn/prune-guides
docs: prune guide catalog and refine topic categories
2026-10-09 11:54:45 +02:00
David Karlsson d837c637cd docs: align guide categories with remaining content
Monitoring guides were grouped under CI/CD, and several other guides had
categories that did not match their main purpose. Add Observability,
rename Deployment to Services & infrastructure, and move LocalStack and
Django into Testing and Languages & frameworks.
2026-10-08 14:22:25 +00:00
David Karlsson 19b44c2f42 docs: remove E2B and Ollama guides
Remove the E2B workflow and integration documentation and both Ollama
application guides. Remove E2B navigation and promotional links.

Redirect former E2B URLs to Docker Sandboxes and former Ollama guide URLs
to Docker Model Runner.
2026-10-08 14:17:22 +00:00
David Karlsson 5542bb1ed4 docs: remove shallow product-tour guides
The Build Cloud, Compose, Scout, Testcontainers Cloud, and
container-supported development guides mostly repeat product benefits
and introduce videos instead of teaching distinct tasks.

Remove these five guides and their unused images, update incoming links,
and redirect all former page and chapter URLs to the relevant product
docs or hands-on lab. Keep both administration guides.
2026-10-08 14:00:49 +00:00
David Karlsson b24d663344 docs: prune specialized Testcontainers integration guides
The Testcontainers collection includes nine specialized Java integration
tutorials with modest readership and overlapping framework setup.

Remove these guides and their links from the Testcontainers overview,
retaining eleven guides covering language introductions, general
techniques, representative web frameworks, and Testcontainers Cloud.
2026-10-08 13:50:14 +00:00
David Karlsson 7a1b2c0627 docs: remove low-use NLP and generic GenAI guides
The NLP examples, TensorFlow.js face detection guide, Neo4j RAG guide,
and video chatbot guide have low readership and repeat application
setup or containerization covered by other guides.

Remove these eight guides and the nine images used only by them.
No remaining content or config entries reference the removed guides.
2026-10-08 13:39:03 +00:00
David Karlsson 2c8a358489 Merge pull request #26311 from docker-tools-robot/dispatch/buildx-ref-v0.38.0
Update buildx reference to v0.38.0
2026-10-08 09:18:51 +02:00
David Karlsson 7ba25eeb0c Merge pull request #26197 from sunm2n/docs-gha-cache-version-defaults
docs: correct GitHub Actions cache version selection
2026-10-07 17:36:47 +02:00
David Karlsson 560172d88a Merge pull request #26166 from jaideepkrishna2008-ui/fix/storage-driver-default-guidance-26163
docs(storage): scope overlay2 driver page to classic storage driver
2026-10-07 14:09:40 +02:00
David Karlsson 65aa5cd481 Merge pull request #26281 from docker/sbx-47-rn
chore: regen sbx v0.47.0 release notes
2026-10-07 09:33:59 +02:00
David Karlsson 852616e9b8 Merge pull request #26284 from dvdksn/fix/api-reference-banner-dark-mode
docs: fix API reference banner contrast in dark mode
2026-10-07 09:11:26 +02:00
David Karlsson f1bfafafb9 chore: regen sbx v0.47.0 release notes
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-06 10:41:19 +02:00
David KarlssonandClaude Opus 5.5 6cf1b1c167 sbx: document v0.47.0 changes (#26247)
## Description

Documents the user-facing changes in Docker Sandboxes v0.47.0 and
updates the CLI reference.

- `sbx run --rm` removes the sandbox when the agent exits, for local and
cloud sandboxes.
- `sbx run --detached` keeps a local sandbox running after its sessions
end.
- Kits can declare the `long-running@1` capability to keep their sandbox
running.
- `sbx move` to the cloud applies the kit's network rules.
- MCP authorization requests `offline_access` with default scopes, so
servers can issue refresh tokens.
- UDP to local-network destinations is blocked regardless of network
policy.
- `sbx --cloud ttl` reports stopped sandboxes as stopped instead of
expired.
- The CLI reference is updated for v0.47.0.

@netlify /ai/sandboxes/usage/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 10:32:33 +02:00
David KarlssonandClaude Opus 5.5 c5ab24b0de sbx: vendor v0.47.0 cli reference
Copied from docker/sandboxes docs/yml at release/v0.47
(0411f50ee470, v0.47.0-rc2).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:22 +02:00
David KarlssonandClaude Opus 5.5 9b52188052 sbx: describe cloud ttl output for stopped sandboxes
sbx --cloud ttl no longer reports a stopped sandbox as expired. Explain
that resuming starts a new time-to-live period and describe the
stopped and ttl_paused JSON fields.

Source: docker/sandboxes#6388

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:22 +02:00
David KarlssonandClaude Opus 5.5 5a4fb43d50 sbx: document the UDP local-network boundary
UDP to multicast, link-local, unspecified, and broadcast destinations
is dropped before policy evaluation, so no allow rule can permit it.
Explain the effect on discovery protocols and how the network log
reports these connections.

Source: docker/sandboxes#5875

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:22 +02:00
David KarlssonandClaude Opus 5.5 a9db96855a sbx: document offline_access for MCP authorization
When sbx uses recorded default or resource-required scopes, it also
requests offline_access if the authorization server advertises it, so
the server can issue a refresh token. Explicit --scope values are
requested as given.

Source: docker/sandboxes#6284

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:22 +02:00
David KarlssonandClaude Opus 5.5 12d9ac4a09 sbx: explain kit network rules on move to cloud
sbx move --to cloud now applies the sandbox's kit or agent network
rules, as sbx --cloud create does. Rules added locally still don't
transfer. Correct the move and cloud network policy pages, which said
no local rules apply.

Source: docker/sandboxes#6707 (backported as #6814)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:21 +02:00
David KarlssonandClaude Opus 5.5 7a3f927057 sbx: document the long-running kit capability
Explain how a kit declares long-running@1 to keep its sandbox running
after sessions end, how required and optional entries behave, and that
cloud sandboxes and sbx kit add can't provide it.

Source: docker/sandboxes#6710

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:21 +02:00
David KarlssonandClaude Opus 5.5 ee651cff08 sbx: document detached local sandboxes
Explain that sbx run --detached keeps a local sandbox running after its
sessions end, and that running it against an existing sandbox switches
that sandbox to detached mode permanently.

Source: docker/sandboxes#6600

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:21 +02:00
David KarlssonandClaude Opus 5.5 777a8a3a41 sbx: document sbx run --rm
Explain that --rm removes a local or cloud sandbox when the agent
session exits, when a reattached sandbox is kept, and why --rm can't be
combined with --detached or --detach-keys.

Source: docker/sandboxes#6601

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-10-05 09:32:21 +02:00
David Karlsson f653d5376d Merge pull request #26255 from glours/bump-compose-v5.6.0
bump compose to version v5.6.0
2026-10-05 08:47:34 +02:00
David Karlsson 5464ceeaef docs(firewall): remove that ufw is shipped with Debian (#26261)
<!--Delete sections as needed -->

## Description

See commit message(s).

Just fixes a small hiccup on the docs! It makes it sounds like Debian
comes with ufw but it doesn't.

> nftables is the default and recommended firewalling framework in
Debian…
> 
> It is recommended to run
[?](https://wiki.debian.org/firewalld)firewalld…
> 
> \- [Debian Wiki: nftables](https://wiki.debian.org/nftables)

Just to confirm, I also installed Debian on a VM and checked if ufw was
present, and indeed it wasn't. This was run on a fresh express Debian
install:

```txt
root@debian13-uni:/home/seth# ufw
bash: ufw: command not found
root@debian13-uni:/home/seth# 
```

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2026-10-05 08:43:07 +02:00
David Karlsson b12ed47c72 Merge pull request #26267 from DeepanshuPal/docs/fix-azure-pipeline-yaml
docs: fix Azure Pipelines job and build-task snippets
2026-10-05 08:39:26 +02:00
David Karlsson dc7d75c3b6 Merge pull request #26272 from dave123981/fix/grammatical-error-unassociated-machines
docs: fix grammatical error in unassociated machines heading
2026-10-05 08:38:52 +02:00
David Karlsson a0c20d3e16 Merge pull request #26273 from nielskaspers/docs-fix-unassociated-machines-domain-link
docs: fix domain management link
2026-10-05 08:38:35 +02:00
David Karlsson 49cc06bd07 Merge pull request #26260 from Huzaifa-Asif/docs/restart-after-logging-config
docs: add commands to restart Docker after logging changes
2026-10-05 08:38:01 +02:00
David Karlsson 318ea7ce22 Merge pull request #26250 from maxcleme/remove-vwo-leftovers
site: remove leftover VWO smartcode
2026-10-02 15:35:46 +02:00