1
0
mirror of https://github.com/docker/docs.git synced 2026-10-28 07:15:09 +03:00
Commit Graph

4992 Commits

Author SHA1 Message Date
Paweł Gronowski
50595451ab engine: 29.6.0
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-06-18 22:44:56 +02:00
David Karlsson
b551052d64 Merge pull request #25390 from dvdksn/sbx/v0.33-release-notes
sbx: regenerate release notes (v0.33.0)
2026-06-18 18:02:15 +02:00
David Karlsson
1389bab673 Merge pull request #25375 from dvdksn/sbx-commercial-use-clarify
Clarify that Docker Sandboxes is free and OK for commercial use
2026-06-18 17:59:08 +02:00
David Karlsson
b586d74072 Merge pull request #25392 from dvdksn/includes-cleanup
Remove unused includes and fail the build on broken include references
2026-06-18 17:55:06 +02:00
David Karlsson
b3d65d3a24 Merge pull request #25389 from dvdksn/worktree-ai-governance-custom-roles
docs: document Governance permissions for custom roles
2026-06-18 16:54:44 +02:00
Jasdeep Singh Bhalla
743f3c261b fix: add missing useState import and remove duplicate ddClient in backend extension tutorial (#25305)
## Summary

- Add `useState` to the React import in the backend extension tutorial
code example — it was used but missing from the import, causing a
compilation error
- Remove the duplicate `createDockerDesktopClient()` call inside `App()`
— `ddClient` is already declared at module scope

## Issue

Fixes #25192
2026-06-18 15:18:04 +01:00
Devendra kushwah
b4f1c16951 Fix broken convert account link in organization FAQs (#25378)
## Description

Fixes a broken relative link in
`content/manuals/admin/organization/organization-faqs.md`.

The FAQ linked to `convert-account.md` in the current directory, but the
file is located in the `setup/` subdirectory. Updated the link to point
to the correct path.

## Related issues or tickets

Fixes #25366

## Reviews

* [x] Technical review
* [ ] Editorial review
* [ ] Product review
2026-06-18 10:54:04 +01:00
David Karlsson
f62d925a50 docs: remove unused includes and fix broken include references
Delete 10 orphaned files under content/includes that are no longer
referenced by any page via the include shortcode:

- aci-ecs-eol.md, compose-eol.md, dev-envs-changing.md,
  dockerfile-labs-channel.md (stale EOL/status callouts)
- buildx-v0.10-disclaimer.md, experimental.md, deploy.md,
  guides-get-docker.md, open-terminal.md (orphaned snippets)
- labspace-quickstart.md (empty)

Also fix two broken include references:

- scout-early-access.md was deleted in 737ad3c4be but two environment
  integration pages still included it; remove the dangling lines.
- reference/compose-file/develop.md included compose/develop.md, which
  does not exist; point it at the real file, compose/services-develop.md.

Every include file is now referenced, and every reference resolves.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 11:06:11 +02:00
David Karlsson
156c14cb2f sbx: regenerate release notes (v0.33.0)
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-06-18 10:54:09 +02:00
David Karlsson
1f4bc7e6cb docs: clarify Sandboxes is free and OK for commercial use
The 'Ask AI' assistant could not answer whether sbx may be used
commercially because the docs never state the licensing terms. Add an
FAQ entry and a front-page callout making clear the sbx CLI is free to
use, including for commercial work, and that only organization
governance requires a paid subscription.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 10:18:05 +02:00
David Karlsson
5d8459e3b8 docs: document Governance permissions for custom roles
Add the Governance permission category (View policies, Manage policies)
to the custom roles permissions reference, and note in the organization
policy page that only owners can manage AI Governance policies by
default, with custom roles available to delegate to non-owners.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 09:28:32 +02:00
David Karlsson
efc13aa86c docs: avoid duplicating read/write mount semantics in org.md
Point org.md to Policy concepts for the read+write requirement instead of
restating it, since the page already links there for filesystem rule syntax.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 08:54:20 +02:00
David Karlsson
1e6666477f docs: tighten port publishing notes into prose
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>
2026-06-18 08:52:19 +02:00
David Karlsson
f039128b21 docs: document filesystem policies in sbx policy ls
Filesystem policy rules are now visible in `sbx policy ls` (TYPE shows
`filesystem:read`/`filesystem:write`, filterable with `--type filesystem`),
and a writable workspace mount requires both read and write access.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 08:48:48 +02:00
David Karlsson
40b8d95b5f docs: sandbox published ports survive restarts
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>
2026-06-18 08:46:03 +02:00
Rafael Coelho Costa
ca15cc4626 docs: fix wording in Docker Scout pages (#25371)
## Description

  Minor editorial fixes in the Docker Scout docs:

- Correct "setup" used as a verb to "set up" in the Integrations and CI
integration page descriptions
  - Remove a duplicated word ("improve improve") in the policy view page

  ## Reviews

  - [ ] Technical review
  - [ ] Editorial review
  - [ ] Product review
2026-06-17 13:34:09 -07:00
Craig Osterhout
4582be6e5f hub: dct updates (#25382)
<!--Delete sections as needed -->

## Description

DCT retirement updates:
- Updated callout based on latest announcement
- Updated troubleshooting section based on latest announcement
- Added to the deprecated-retired page

Previews:
-
https://deploy-preview-25382--docsdocker.netlify.app/retired/#docker-content-trust-dct
-
https://deploy-preview-25382--docsdocker.netlify.app/docker-hub/image-library/trusted-content/#troubleshooting-failed-pulls
-
https://deploy-preview-25382--docsdocker.netlify.app/engine/security/trust/

## Related issues or tickets

ENGDOCS-3321

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-06-17 11:54:55 -07:00
David Karlsson
948c5e6934 Merge pull request #25329 from dvdksn/worktree-sandboxes-docs-post-v0.32
docs(sandboxes): post-v0.32.0 doc updates
2026-06-17 20:51:03 +02:00
David Karlsson
f4dfdeed29 docs: document router-assigned (SLAAC) IPv6 on macvlan/ipvlan (#25376)
Adds a "Use router-assigned IPv6 addresses" subsection to the macvlan
and ipvlan driver pages, covering how to receive IPv6 via SLAAC from a
router on the parent network instead of Docker IPAM.

When the network has no IPv6 subnet, Docker disables IPv6 on the
endpoint; setting the per-interface `net.ipv6.conf.IFNAME.disable_ipv6`
sysctl to `0` via the `endpoint.sysctls` driver option re-enables it so
the interface accepts router advertisements. The section links to the
`docker network connect` sysctl reference for the full mechanism. Also
adds `ipv6`/`slaac` keywords to both pages for discoverability.

Motivated by
[moby/moby#52815](https://github.com/moby/moby/issues/52815), where the
per-endpoint sysctl mechanism was hard to discover from the driver docs.

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

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 16:16:52 +02:00
Rebaka8
a9278c30e6 Merge pull request #25348 from Rebaka8/docs/awslogs-credential-refresh-note
Add note about temporary credential refresh behavior for awslogs
2026-06-17 15:26:47 +02:00
Rob Murray
7ce3fd0512 docs: document router-assigned (SLAAC) IPv6 on macvlan/ipvlan
Add a "Use router-assigned IPv6 addresses" subsection to the macvlan and
ipvlan driver pages explaining how to receive IPv6 addresses via SLAAC
instead of Docker IPAM. Setting the per-interface net.ipv6.conf.IFNAME.disable_ipv6
sysctl to 0 via the endpoint.sysctls driver option re-enables IPv6 on the
interface so it can accept router advertisements, and the section links to
the docker network connect sysctl reference for the full mechanism.

Also add ipv6 and slaac keywords to both pages to improve discoverability.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 14:17:11 +01:00
David Karlsson
d22eea2e85 docs: fix minor grammar errors (#25372)
## Description

  Fix several small grammar errors across the docs:

- **GitHub Actions CI guides** (Python and Ruby): `This workflow is
runs` → `This workflow runs`; `tab of you GitHub repository` → `of your
GitHub repository`; `[Login to Docker Hub]` link text → `[Log in to
Docker Hub]`, matching the adjacent "Set up Docker Buildx" step
- **build/ci/github-actions/configure-builder**: `a node in an
underlying step of you workflow` → `of your workflow`
- **Bind mounts page** (get started): remove a stray article in image
alt text — `inside the a container` → `inside the container`
- **Database pre-seeding guide**: `let you access to the Postgres
database` → `letting you access the Postgres database`; `It also define`
→ `It also defines`

  ## Reviews

  - [ ] Technical review
  - [ ] Editorial review
  - [ ] Product review
2026-06-17 14:34:36 +02:00
Rafael Coelho
dcfd3df3cb docs: fix assorted grammar errors
- Python/Ruby GitHub Actions CI guides: 'is runs' -> 'runs', 'of you' ->
    'of your', and 'Login to Docker Hub' link text -> 'Log in to Docker Hub'
  - configure-builder: 'of you workflow' -> 'of your workflow'
  - bind-mount page: remove stray article ('the a container' -> 'the container')
  - pre-seeding guide: 'let you access to' -> 'letting you access', 'define' -> 'defines'
2026-06-17 09:10:12 -03:00
David Karlsson
5c6048e833 docs: add shell environment customization to kit examples
Show how to source a tool's init script as part of a kit so its command
lands on PATH in every shell, using nvm as a worked example. nvm
installs cleanly in a default sandbox (reachable egress, no extra
packages), so the snippet works as copy-pasted.

Append to /etc/sandbox-persistent.sh — the sandbox's established
persistent environment file, sourced for both interactive and
non-interactive shells — to match the convention documented in the FAQ
for custom environment variables, and cross-link it.

Also document install-command gotchas that apply to any download-based
kit: deny-by-default egress can silently block downloads, curl | bash
masks those failures (exits 0), install steps run under sh not bash, and
some tools need base packages such as zip/unzip.

Add nvm to the Vale vocabulary.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 12:46:15 +02:00
Devendra kushwah
06c12e8367 Fix broken SSO removal anchor link (#25370)
Fixes a broken anchor link in
`content/manuals/admin/organization/deactivate-account.md`.

The existing link pointed to `#remove-an-organization`, which does not
exist in the target document. Updated it to `#delete-a-connection`,
which points to the correct section for removing an SSO connection.

## Related issues or tickets

Fixes #25367

## Reviews

* [x] Technical review
* [ ] Editorial review
* [ ] Product review
2026-06-17 07:54:49 +01:00
Alexa Kristensen
0c000459f5 Update warning for organization access tokens (#25364)
Update per IAM team
2026-06-16 11:08:45 -05:00
David Karlsson
e438ec391c docs(sandboxes): restructure credentials page around the credential model
Lead "How credential injection works" with the injection model and an
orientation table (which form to use, when), and group the value sources.
Reframe registry credentials by purpose and isolation posture rather than as
the "non-injection" outlier: explain the host-only/global/sandbox scopes
upfront, that in-sandbox credentials are written to ~/.docker/config.json at
creation time (less isolated than proxy injection), and show the store-then-run
ordering. Add a best-practices note on the registry isolation tradeoff.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 16:14:23 +02:00
David Karlsson
9324a4f75b docs(sandboxes): document opt-in image paste into agents
Ctrl+V image/screenshot paste into sandboxed agents (Claude Code, Codex)
is opt-in via the clipboard.imagePaste setting. Added an FAQ entry
covering how to enable it and the isolation tradeoff: enabling it lets a
sandbox process read the host clipboard through the proxy, scoped to
image data only and never cached or logged.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 15:59:22 +02:00
David Karlsson
f477bcaf9b docs(sandboxes): correct post--- argument behavior for agent defaults
Arguments after `--` no longer wholesale-replace an agent's default
entrypoint flags. The default flags are now kept when the first user
argument is itself a flag (begins with `-`), and replaced only when the
first argument is a bare word (a subcommand or prompt). Updated the
"Default startup command" section on each affected agent page and fixed
examples that re-included flags now retained automatically.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 15:59:22 +02:00
David Karlsson
5f50b58765 docs(sandboxes): virtiofs cache is now enabled by default on macOS and Linux
Direct-mode virtiofs caching is now on by default on macOS and Linux;
Windows remains opt-in. Corrected the troubleshooting guidance, which
still described caching as disabled by default, and documented
DOCKER_SANDBOXES_ENABLE_VIRTIOFS_CACHE=0 as the kill switch.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 15:59:22 +02:00
David Karlsson
07e45f0483 docs(sandboxes): document wildcard --host patterns for custom secrets
sbx secret set-custom --host accepts wildcards (* for a single label, **
for any number), using the same syntax as network rules. Added a note and
examples alongside the repeatable --host guidance.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 15:59:22 +02:00
David Karlsson
d2ec0d8fb2 docs(sandboxes): document --name as primary sandbox identity key
--name now identifies a sandbox independently of the working directory.
Expanded the reconnecting and naming section to cover: re-attaching by
name from any directory, re-running a create command to reconnect without
error, and using distinct names to run multiple sandboxes against the
same workspace.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 15:59:22 +02:00
David Karlsson
bd25cced99 docs(sandboxes): document multiple --host patterns for custom secrets
sbx secret set-custom --host is now repeatable, so one secret entry can
cover multiple domains. Added a second example showing the multi-host
form and updated the prose to reflect that the proxy matches any of the
configured hosts.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 15:59:22 +02:00
David Karlsson
a5fd2021c7 docs(sandboxes): add agent field to audit log schema
Audit records now include an `agent` field identifying which AI agent
drove the sandbox (claude, codex, etc.), so multi-agent deployments can
attribute policy decisions per agent. Added to the example record and the
field reference table.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 15:59:22 +02:00
David Karlsson
568de235c9 docs(sandboxes): clarify DNS resolution is policy-gated in network isolation
Sandbox DNS lookups now go through the same policy engine as TCP
connections — a denied domain is refused at the resolver level, not just
the connection level. Updated the network isolation description to reflect
this guarantee rather than describing DNS as merely proxied.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 15:59:21 +02:00
Paweł Gronowski
6d759c7482 Merge pull request #25070 from AkihiroSuda/rootless-29.5-fix
engine/security/rootless/troubleshoot: fix "Historical limitations"
2026-06-16 14:28:40 +02:00
Allie Sadler
3fe12de8c0 extensions: marketplace pause (#25362)
<!--Delete sections as needed -->

## Description

Adds callouts to relevant pages for extensions marketplace update

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-06-16 07:32:39 +01:00
Craig Osterhout
d1430fb94f dhi: alpine 3.24 updates (#25345)
<!--Delete sections as needed -->

## Description

A few small changes to account for the Alpine 3.24 updates that are
rolling out.
- Added Alpine 3.24 to the yaml build spec topic
- Added Alpine 3.23 and later to the GUI customization hsp flow.
- Added Alpine 3.24 hsp repo note to packages example

## Related issues or tickets

ENGDOCS-3323

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-06-15 17:00:10 -07:00
Craig Osterhout
b4f08ba8de dhi: update supported scanners (#25344)
<!--Delete sections as needed -->

## Description

- Added a new supported scanner.
- Changed list to a table for better scanability.
- Removed paywalled/login-walled third-party scanners from the how-to
since we just point to their docs, and it's getting weird as the list
grows.
- Removed blogs from additional resources rather than adding the Aikido
blog. Blogs were taking the place of release notes, but now we have
quarterly release notes.

## Related issues or tickets

ENGDOCS-3324

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-06-15 08:29:12 -07:00
Jasdeep Singh Bhalla
338ecb5235 Merge pull request #25308 from jasdeepbhalla/fix/pull-no-cache-clarify-best-practices
docs: clarify distinct purposes of --pull and --no-cache flags
2026-06-15 14:35:34 +02:00
David Karlsson
5c562fed32 docs: surface the cgroup v2 limitation earlier in runtime metrics (#24914)
## Description

- surface the cgroup v2 limitation earlier in the runtime metrics page
- clarify that the detailed metrics section currently documents the
cgroup v1 file layout
- point cgroup v2 readers to the container-specific controller files
they should inspect

## Related issues or tickets

- Addresses #24644

## Guideline alignment

- followed `docs/CONTRIBUTING.md`
- kept the change to one documentation file and one focused issue

## Validation

- not run (`docker buildx bake validate`) because this is a docs-only
clarification

## Reviews

- [x] Technical review
- [ ] Editorial review
- [ ] Product review
2026-06-15 14:31:18 +02:00
Rob Murray
0339a8afd8 Merge pull request #25359 from robmry/docs/sandbox-upstream-proxy
docs: document upstream proxy chaining for sandboxes
2026-06-15 12:39:13 +02:00
Allie Sadler
06ee93e101 4.77 rn addition (#25360)
<!--Delete sections as needed -->

## Description


https://docker.slack.com/archives/C057F9PLBAL/p1781274000301349?thread_ts=1780318350.641339&cid=C057F9PLBAL

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-06-15 11:21:48 +01:00
Allie Sadler
cae591f617 4.78 docs updates (#25312)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-06-15 10:57:51 +01:00
Allie Sadler
ef86ababc5 4.78 RN (#25311)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: aevesdocker <allie.sadler@docker.com>
2026-06-15 10:57:36 +01:00
Niels Kaspers
b97068282d docs: update MCP integration keyword to Docker Agent 2026-06-15 12:05:12 +03:00
David Karlsson
827a267752 Merge pull request #25347 from Rebaka8/fix-model-runner-flag-docs
Clarify uninstall-runner images and models behavior
2026-06-15 10:49:22 +02:00
David Gageot
3f9f3cd6f7 fix: correct OpenAI-compatible provider examples
The OpenAI-compatible provider examples nested model settings under a
`provider:` key directly on the agent, which is not a valid field and
fails with `unknown field "provider"`. Define a named model in the
`models` section instead and reference it from the agent.

Fixes docker/docker-agent#3121
2026-06-15 10:23:34 +02:00
David Karlsson
3fe911f318 Merge pull request #25339 from dvdksn/worktree-split-kits-reference
Split kit spec reference and update kit field renames
2026-06-15 10:07:07 +02:00
Rebaka8
b49196f241 Clarify uninstall-runner images and models behavior 2026-06-13 19:22:50 +05:30