1
0
mirror of https://github.com/docker/docs.git synced 2026-10-23 18:09:02 +03:00

68127 Commits

Author SHA1 Message Date
Alexa Kristensen
b71dd84bd2 docs: expand Desktop releases FAQ for support and older installs (#26415)
## Summary

Adds FAQs for the six-month support window, installing an older build,
and 403 download errors, and notes that Always download updates is Mac
and Windows only.

@netlify /desktop/troubleshoot-and-support/faqs/releases/

**Preview:**
https://deploy-preview-26415--docsdocker.netlify.app/desktop/troubleshoot-and-support/faqs/releases/

Generated by Cursor

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 07:17:00 -05:00
Alexa Kristensen
7c82035bcb docs: clarify how to view and change plans (#26417)
## Summary

The billing pages repeated steps covered elsewhere and never said what
each screen shows. Plan pages also left out the actions available from
Docker Home. This explains each Billing screen, documents those actions,
and points plan changes at the plans catalog instead of repeating them.

@netlify /subscription-billing/plans/

Preview:
-
https://deploy-preview-26417--docsdocker.netlify.app/subscription-billing/plans/
-
https://deploy-preview-26417--docsdocker.netlify.app/subscription-billing/manage/plans/
-
https://deploy-preview-26417--docsdocker.netlify.app/subscription-billing/plans/ai-governance/
-
https://deploy-preview-26417--docsdocker.netlify.app/subscription-billing/plans/docker-verified-publisher/

Generated by Cursor

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 07:16:26 -05:00
Zainab Oladimeji
4cedf2e052 docs(ai): standardize Gordon free-tier terminology (#26420)
## Description

Standardizes the terminology used to describe Gordon’s free tier across
the documentation.

- Replaces **“Personal (free) subscription”** with **“Base tier
(free)”** in the Gordon data privacy documentation.
- Aligns the terminology with the existing Gordon usage-limits
documentation.
- Preserves the existing data retention policy and all related
explanations.

This change improves consistency and clarity for readers without
changing the documented data privacy practices.

## Related issues or tickets

Closes #26419

## Reviews

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-10-23 11:26:19 +02:00
Allie Sadler
09d7cacc04 4.96.3 rn (#26418)
<!--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-10-22 18:58:42 +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
Allie Sadler
4d64a8e4f0 4.96.2 RN (#26409)
<!--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>
Co-authored-by: Craig Osterhout <craig.osterhout@docker.com>
Co-authored-by: george <george@gabolaev.com>
2026-10-21 20:43:47 -07:00
Oladosu Ibrahim
226023fc89 Merge pull request #26141 from Sudaisib/fix/26135-ipvlan-description
Fix/26135 ipvlan description
2026-10-21 15:48:30 +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
Alexa Kristensen
f33d8e3c80 docs: refresh the subscription plan catalog (#26395)
Refresh on top billing docs :) 

TO DO:

Confirm Docker Offload situation
Remove random link to Testcontainers (?)
Review that Manage your plans h2 lol

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-21 08:28:24 -05:00
Alexa Kristensen
50daf37e9e Frt1 102026 sweep (#26397)
fixingh mentions of "docker personal" when it refers to individual
accounts and not the plan

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-21 08:07:32 -05:00
Allie Sadler
6abf845039 4.96.1 rn (#26406)
<!--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-10-21 13:57:38 +01: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
Allie Sadler
89c936183d Compose module update (#26402)
<!--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-10-21 12:48:50 +01: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
CrazyMax
a356e2a80e Merge pull request #26399 from docker-tools-robot/dispatch/buildx-ref-v0.38.1
Update buildx reference to v0.38.1
2026-10-21 11:54:10 +02:00
Manuel de la Peña
76fb601f73 docs(sandboxes): add Orca SSH integration page (#26282)
## Description

Orca is an agent development environment that runs coding agents in
parallel,
each in its own git worktree. It connects to a sandbox as a plain SSH
host and
installs its own relay inside it, so this works today with no changes on
either
side, and nothing documents it yet.

The page covers the SSH target fields (including the `_default_user_`
username), the C++ compiler Orca's remote terminals need, how agent
selection
works, and credential injection. It follows the shape of the T3 Code
page.

A separate change adds a C/C++ toolchain to the full sandbox templates.
Template
images publish independently of an `sbx` release, so the manual install
here
stops being necessary as soon as the new images carry the toolchain, and
I'll
follow up to drop it once I can pull one that does.

The T3 Code page gets the same one-line change, since it documents the
same
manual install and should name the same package.

Left out deliberately: Orca also offers an "Orca-managed Node" runtime
per SSH
target, which uploads its own Node and needs no compiler at all. I have
not
tested that path against a sandbox, so it stays out until I have.

## Related issues or tickets

- https://github.com/stablyai/orca/issues/13665

## Reviews

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

---------

Signed-off-by: Manuel de la Peña <manuel.delapena@docker.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-10-21 11:30:12 +02:00
Arun Allamsetty
7e40e5a15d DCL-2208 Point the get-offload link at the Offload checkout (#26398)
## Description

The Offload CLI prints `https://docs.docker.com/go/get-offload` when an
account has no Offload access. This PR changes where that short link
goes.

- Before: `https://app.docker.com/billing/catalog`, added in #26303.
- After:
`https://app.docker.com/billing/subscription/dap/compute?returnTo=https://docs.docker.com/offload/quickstart/&ref=cli&refAction=NotEntitled`.

The new target opens the Offload checkout directly. It asks the user to
log in first, then sends them to the checkout of their personal account.
A user who already has Offload skips checkout. After checkout, the user
returns to the Offload quickstart.

`ref=cli` and `refAction=NotEntitled` tell the app-ui checkout events
that the visit came from the CLI. The checkout keeps both params on
every step through to the success page. This lets us measure the Offload
sign-up funnel from the CLI. The app-ui changes are
docker/frontends#17539 and docker/frontends#17544, and both are in
production.

## Related issues or tickets

- DCL-2208: make the Offload web sign-up funnel measurable from end to
end.
- #26303 added the current `/go/get-offload/` redirect.

## Reviews

- The redirect handler (`hack/releaser/cloudfront-lambda-redirects.js`)
already supports targets with a query string, for example the `utm_*`
targets in the same file. It also appends any query params on the
incoming request.
- The checkout accepts `returnTo` only for HTTPS addresses on
`docker.com` hosts, so the quickstart address is accepted.
- To test after deploy, open `https://docs.docker.com/go/get-offload/`
while logged in to Docker. You land on the Offload checkout, and the
address has `ref=cli`.

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

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

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 08:15:56 +01: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
Maria Ines Parnisari
90ae3c732f chore: fix random things in latest.yaml 2026-10-20 17:56:12 -07:00
docker-tools-robot
055d9d5cec vendor: github.com/docker/buildx v0.38.1
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-10-21 00:12:52 +02:00
Paweł Gronowski
d8edfe0d28 Merge pull request #26396 from vvoland/update-docker
engine: 29.9.2
2026-10-20 22:49:34 +02:00
Alexa Kristensen
dd87a3d651 docs: replace JIT flow graphics with a Mermaid diagram (#26370)
## Summary

Replace the two JIT sign-in diagrams with one Mermaid flowchart, and
retitle the sections so setup, disable, and re-enable are distinct
tasks.

Agent readiness scores increased to 98, up from 94 for the live doc.

@netlify /security/provisioning/just-in-time/

Preview:
https://deploy-preview-26370--docsdocker.netlify.app/security/provisioning/just-in-time/

Generated by Cursor Grok

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-20 15:03:24 -05:00
Paweł Gronowski
e15b1328af engine: 29.9.2
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-10-20 21:38:13 +02:00