Commit Graph

66513 Commits

Author SHA1 Message Date
David Karlsson
db740fe266 docs: add auto/system theme option to theme toggle (#24519)
> 🤖 Generated with [Claude Code](https://claude.com/claude-code)

## Summary

`theme.js` unconditionally wrote the resolved preference to
`localStorage` on every page load, permanently locking in a concrete
`"light"` or `"dark"` value even for first-time visitors — making it
impossible to track OS preference changes after any site visit. Removed
the unconditional `localStorage.setItem` from `theme.js` so the early
script only reads (never writes); the Alpine.js toggle in `header.html`
now cycles through three states (light → dark → auto), with "auto"
removing the `theme-preference` key and resolving from
`prefers-color-scheme` with a live `matchMedia` change listener so the
theme updates immediately when the OS preference changes. A contrast
icon indicates auto mode; all three icon spans are driven by Alpine
`x-show` directives rather than pure CSS dark-mode classes.

**Verified:** logic matches the standard three-state pattern;
`prefers-color-scheme` media query and `matchMedia` change listener are
the canonical browser APIs for system-preference tracking.
**Checked:** no other files reference `theme-preference` or the theme
toggle; no CSS changes required.

Closes #23177

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-02 06:19:52 +02:00
Paweł Gronowski
850c008d85 Merge pull request #24598 from vvoland/update-distros
engine/install: Add Fedora 44 and Ubuntu 26.04 as supported distros
2026-04-01 15:41:32 +02:00
Paweł Gronowski
d0cf4cb7fc engine/install: Add Fedora 44 and Ubuntu 26.04 as supported distros
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-04-01 15:18:49 +02:00
David Karlsson
959fc6aea9 Merge pull request #24596 from dvdksn/sbx-policy-org-vs-userdefined
sbx: clarify org/local policy and user defined setting
2026-04-01 11:11:58 +02:00
David Karlsson
90404458e1 sbx: clarify org/local policy and user defined setting
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-01 10:43:33 +02:00
Louis-Arnaud
e8fd109e89 Rephrase version prerequisite in private marketplace docs (#24579)
## Description

The prerequisites section states "Docker Desktop 4.26.0 or later" as a
download requirement, which becomes stale as new versions are released.

This rephrases the version reference as a historical fact ("Private
marketplace support was introduced in Docker Desktop 4.26.0") rather
than a prerequisite, making it resistant to staleness.

Fixes #24547

---------

Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-01 08:47:08 +01:00
Louis-Arnaud
3f8a75a56e Rephrase settings file rename as historical fact (#24580)
## Description

The documentation uses time-relative language ("for Docker Desktop
versions 4.34 and earlier") when mentioning the old `settings.json` file
name, which becomes increasingly stale over time.

This rephrases it as a historical fact: the file was renamed from
`settings.json` to `settings-store.json` in Docker Desktop 4.35.

Fixes #24546

---------

Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-01 08:46:38 +01:00
Mathieu Champlon
bca394691c Update information about MSI bug (#24595)
## Description

Update with more information about the MSI bug for versions between 4.59
and 4.65.

## Related issues or tickets

https://docker.atlassian.net/browse/DKP-2697

## Reviews

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

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

---------

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2026-04-01 07:43:05 +00:00
David Karlsson
62244cf650 Merge pull request #24574 from lacatoire/fix/issue-24555-vmm-currently-beta
Remove time-relative language from VMM settings
2026-04-01 07:50:48 +02:00
David Karlsson
49004bc77f Merge pull request #24581 from lacatoire/fix/issue-24545-admin-settings-workaround
Clarify admin-settings.json workaround version scope
2026-04-01 07:47:11 +02:00
David Karlsson
55c0a8ff42 Merge pull request #24583 from lacatoire/fix/issue-24490-security-faq-roadmap
Remove roadmap language from security FAQ
2026-04-01 07:45:49 +02:00
David Karlsson
47dc3d43ee Merge pull request #24573 from lacatoire/fix/issue-24557-hyperkit-deprecation
Fix stale framing of HyperKit deprecation
2026-04-01 07:45:25 +02:00
Craig Osterhout
d64c51fc70 dhi: enterprise get-started wording fix (#24592)
<!--Delete sections as needed -->

## Description

Clarified the prerequisites structure in the DHI Enterprise guide. The
previous wording incorrectly listed Docker Desktop 4.65+ as part of "one
of the following" options, making it appear optional or mutually
exclusive with the subscription/trial requirement.

Changed:

- Restructured prerequisites to show Docker Desktop 4.65+ is always
required (not optional) for CLI
Clarified that "one of the following" applies only to the
subscription/trial choice
- Made it clear there are 3 distinct prerequisites:
  - Organization owner access (required)
  - DHI Select/Enterprise subscription OR trial (required - pick one)
  - Docker Desktop 4.65+ (required for cli)

## Related issues or tickets

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

## Reviews

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

- [ ] Editorial review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-04-01 07:43:18 +02:00
Craig Osterhout
b402038a4f dhi: add fips entropy source (#24542)
<!--Delete sections as needed -->

## Description

Added FIPs entropy source info

## Related issues or tickets

ENGDOCS-3219

## Reviews


- [ ] Technical review
- [ ] Editorial review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-03-31 15:37:27 -07:00
David Karlsson
769b9a91d1 Merge pull request #24593 from mikesir87/swap-custom-catalog-example
Swap server names to use valid names in the MCP Catalog
2026-03-31 22:34:08 +02:00
Michael Irwin
0fc8c1de7b Swap server names to use valid names in the MCP Catalog 2026-03-31 16:21:57 -04:00
Rohan Santhosh Kumar
85582ec048 docs: fix output heading in PostgreSQL guide (#24563)
## Description

- Fix the `Outout` typo in the example output heading in the PostgreSQL
networking guide.
- Validation: not run locally; docs-only change.

## Related issues or tickets

- N/A

## Reviews

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

Co-authored-by: rohan436 <rohan.santhoshkumar@googlemail.com>
2026-03-31 12:30:18 -07:00
David Karlsson
04f9e20d53 Merge pull request #24591 from dvdksn/sbx-follow-up-fixes
sandboxes: follow-up fixes and clarifications from sbx docs rewrite
2026-03-31 19:01:13 +02:00
CrazyMax
77abf022be Merge pull request #24589 from docker-tools-robot/dispatch/buildx-ref-v0.33.0
Update buildx reference to v0.33.0
2026-03-31 18:02:09 +02:00
David Karlsson
4e849afff8 Merge pull request #24590 from dvdksn/sbx
sbx
2026-03-31 18:01:55 +02:00
crazy-max
f0bb45f6e3 vendor: github.com/docker/buildx v0.33.0
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-03-31 15:35:07 +00:00
David Karlsson
cdde205ba8 sandboxes: add sbx documentation
Add full documentation for the sbx CLI sandbox experience including
get-started, usage guide, architecture, agents (claude-code, codex,
copilot, gemini, kiro, opencode, cagent, custom-environments),
security (isolation, credentials, policy, workspace trust),
troubleshooting, and FAQ. Update _index.md as the section landing
page.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-31 17:35:01 +02:00
David Karlsson
b798419066 feat: rewrite skills/agent docs (#24584)
Adds core skills for working with docker/docs - catches common issues
and improves agent task execution. These tasks were derived from a
self-learning harness setup I've used separately; but a separate harness
doesn't exactly work well as a collaboration platform. So this PR merges
the main features of the harness into the canonical repo.

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-31 16:52:02 +02:00
David Karlsson
258466b72a sandboxes: consolidate classic sandboxes to single page
Remove individual subpages (agents, architecture, get-started,
network-policies, workflows, templates, migration, troubleshooting)
and replace with a single docker-desktop.md page. Update _index.md
as a minimal landing page for the section.
2026-03-31 15:22:47 +02:00
David Karlsson
2c4facb6d0 feat: rewrite skills/agent docs
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-31 15:20:07 +02:00
Louis-Arnaud
658a21f6c4 Clarify legacy builder note for Windows container builds (#24587)
## Description

The note about Windows container builds uses passive voice ("the legacy
builder is used") which makes the behavior unclear. Readers can't tell
if this is expected behavior or a temporary limitation.

Rewritten in active voice to make the cause and workaround clear: the
`docker build` command uses a legacy builder, and here is how to switch
to BuildKit to see builds in the Builds view.

Fixes #24453
2026-03-31 13:19:21 +02:00
Louis-Arnaud
2da318fd28 Merge pull request #24578 from lacatoire/fix/issue-24531-get-started-version-note
Clarify version-specific note about AI settings location
2026-03-31 13:18:26 +02:00
David Karlsson
e405d50f93 Merge pull request #24585 from lacatoire/fix/issue-24571-semantic-embeddings-guidance
Add use-case guidance for semantic-embeddings RAG strategy
2026-03-31 12:20:10 +02:00
David Karlsson
c92cd60124 Merge pull request #24582 from lacatoire/fix/issue-24516-bake-targets-hedge-word
Remove hedge word from Bake wildcard pattern note
2026-03-31 12:19:17 +02:00
David Karlsson
7b6fd9f3c5 Merge pull request #24586 from lacatoire/fix/issue-24568-a2a-experimental
Remove time-relative language from A2A experimental notice
2026-03-31 11:22:13 +02:00
David Karlsson
c0c1108214 Merge pull request #24588 from lacatoire/fix/issue-24570-config-typo-terminology
Fix typo in Docker Agent config reference
2026-03-31 11:16:54 +02:00
lacatoire
275ab0aed4 Fix typo: "suing" to "using" in Docker Agent config reference
Fixes #24570
2026-03-31 11:12:01 +02:00
lacatoire
08efa4f9ee Remove time-relative language from A2A experimental notice
Replace "currently experimental and needs further work" with
"experimental" and "not yet integrated" with "not integrated"
per STYLE.md conventions.

Fixes #24568
2026-03-31 11:10:02 +02:00
lacatoire
5990d924e7 Add use-case guidance for semantic-embeddings RAG strategy
Add a "Best for..." statement to the semantic-embeddings description,
matching the pattern used by chunked-embeddings and BM25, so readers
can compare strategies at a glance.

Fixes #24571
2026-03-31 11:08:49 +02:00
lacatoire
24155e8620 Remove roadmap language from security FAQ
Remove "on the roadmap" and "currently" from the extension security
vetting FAQ entry, keeping a timeless factual statement per STYLE.md
conventions.

Fixes #24490
2026-03-31 11:06:44 +02:00
lacatoire
25449a1a78 Remove hedge word from Bake wildcard pattern note
Replace "which usually causes errors" with "causing errors" for
clearer, more direct guidance per STYLE.md conventions.

Fixes #24516
2026-03-31 11:05:58 +02:00
David Karlsson
37c4c90934 Merge pull request #24577 from lacatoire/fix/issue-24532-vllm-version-context
Clarify vLLM minimum version requirement
2026-03-31 11:05:43 +02:00
lacatoire
c6f7a0e346 Clarify admin-settings.json workaround version scope
Rephrase the version-specific workaround to clearly state which
versions require the manual deletion step and that version 4.60+
no longer needs it.

Fixes #24545
2026-03-31 11:04:43 +02:00
lacatoire
5556b603d0 Clarify vLLM minimum version requirement in inference-engines.md
Add context that Docker Desktop 4.54 is the minimum version for vLLM
support, making the version reference self-explanatory and resistant
to staleness.

Fixes #24532
2026-03-31 11:00:32 +02:00
David Karlsson
f6eda0a498 Merge pull request #24576 from lacatoire/fix/issue-24530-model-runner-now
Remove time-relative language from Model Runner docs
2026-03-31 10:51:44 +02:00
David Karlsson
70daa906ca Merge pull request #24572 from lacatoire/fix/issue-24564-otel-currently
Remove time-relative language from CLI OpenTelemetry docs
2026-03-31 10:51:04 +02:00
lacatoire
adbdcd5113 Remove time-relative language from Model Runner docs
Fixes #24530
2026-03-31 10:22:22 +02:00
lacatoire
6a9a2c1c69 Remove time-relative language from VMM settings
Fixes #24555
2026-03-31 10:21:46 +02:00
lacatoire
4647ec323b Fix stale framing of HyperKit deprecation
Fixes #24557
2026-03-31 10:20:12 +02:00
lacatoire
2282ca8c62 Remove time-relative language from CLI OpenTelemetry docs
Fixes #24564
2026-03-31 10:13:27 +02:00
Kristiyan Velkov
ffcbd750c3 [feat] added next.js documentation -sample guide based on the next.js documentation (#24402)
## Description

Adds a **Next.js language-specific guide** under
`content/guides/nextjs/`:

- **_index.md** — Overview, prerequisites, what you’ll learn
- **containerize.md** — `docker init`, multi-stage Dockerfile,
standalone/export, production image
- **develop.md** — Compose dev/prod setup, Compose Watch, hot reload
- **run-tests.md** — Vitest/Jest and ESLint in containers
- **configure-github-actions.md** — CI/CD with GitHub Actions → Docker
Hub
- **deploy.md** — Deploy to local Kubernetes (Docker Desktop)

Uses sample app:
[kristiyan-velkov/docker-nextjs-sample](https://github.com/kristiyan-velkov/docker-nextjs-sample).

## Related issues or tickets

_None_

## Reviews

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

---------

Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-31 08:54:40 +02:00
Craig Osterhout
3c87de0c42 dhi: add enterprise get started (#24529)
<!--Delete sections as needed -->

## Description

Added a get-started with DHI Select & Enterprise topic to show a
complete end-to-end workflow with a real example. Current location is in
how-to in order to keep the primary community get-started upfront for
now.
Updated the community get-started.

## Related issues or tickets

ENGDOCS-3217

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-03-30 08:49:40 -07:00
Lorena Rangel
4210ae6be8 Fix Slack notification for release notes PRs from forks (#24566)
## Description

The Slack notification workflow for Desktop release notes PRs fails when
the PR is opened from a fork because GitHub doesn't expose repository
secrets to `pull_request` events from forks.

This PR splits the workflow into two:

1. **Release Notes PR Trigger** — runs on `pull_request`, saves PR
   details (URL, title, author) as an artifact. No secrets needed.
2. **Notify Slack on Desktop Release Notes PR** — runs on `workflow_run`
   after the trigger completes, downloads the artifact, and sends the
Slack notification. Has access to secrets since `workflow_run` runs in
   the context of the base repository.

## Related issues or tickets

Fixes the `SlackError: Missing input! A token must be provided` error
in the notify-release-notes-pr workflow.

## Reviews

- [x] Technical review

Signed-off-by: Lorena Rangel <lorena.rangel@docker.com>
2026-03-30 13:41:24 +01:00
David Karlsson
7ae0e554d0 Merge pull request #24551 from ilya-grigoriev/patch-1
Update lifecycle.md
2026-03-30 13:28:59 +02:00
Luca Guerra
bc0358ad62 4.67 security release notes (#24565)
## Description

Add security notes to the 4.67.0 release

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-03-30 11:31:24 +01:00