1
0
mirror of https://github.com/docker/docs.git synced 2026-10-25 06:09:46 +03:00

685 Commits

Author SHA1 Message Date
CrazyMax
0d507914cf build: Buildx OCI artifact opt-out
Document BUILDX_NO_DEFAULT_OCI_ARTIFACT as a compatibility escape hatch for registries that reject OCI artifact attestations.

Add the corresponding Buildx version requirement to the summary bar metadata.

Signed-off-by: CrazyMax <1951866+crazy-max@users.noreply.github.com>
2026-08-04 17:48:12 +02:00
Allie Sadler
8fddfffa4d offload: cli updates (#25704)
<!--Delete sections as needed -->

## Description

Updates as per
https://docker.slack.com/archives/C0986V1DVG8/p1785790049918399

## 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-08-04 13:33:23 +01:00
David Karlsson
d552b43c5c Merge pull request #25631 from dvdksn/codex/learn-exact-path-redirect
docs: redirect bare Learn path
2026-08-04 08:52:06 +02:00
Craig Osterhout
d1eaa21fd5 ai-audit-logs: add siem catalog (#25687)
<!--Delete sections as needed -->

## Description

There's a new SIEM catalog in addition to the Custom HTTPS endpoint.

- Created dedicated SIEM connector topic with more info
- Removed SIEM info from view and export topic
- Updated index with new topic

Preview:
https://deploy-preview-25687--docsdocker.netlify.app/ai/sandboxes/governance/audit/siem/

Added summary bar with min version.
Preview:
https://deploy-preview-25687--docsdocker.netlify.app/ai/sandboxes/governance/audit/

## Related issues or tickets


## 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-08-03 11:14:43 -07:00
David Karlsson
75deb7f882 docs: redirect bare Learn path 2026-08-03 14:12:21 +00:00
github-actions[bot]
9a21f9c9a8 cli: sync docs with docker/cli v29.7.1 2026-08-03 03:12:50 +00:00
docker-tools-robot
68a46568db vendor: github.com/docker/buildx v0.36.0
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-07-29 22:29:40 +02:00
Craig Osterhout
50c34ba440 dhi: sync cli ref (#25634)
<!--Delete sections as needed -->

## Description

Synced DHI CLI docs:
- Release notes — Added v0.0.6 and v0.0.7 to the DHI CLI release notes
page.
- Reference YAML — Synced commands (these syncs got missed a previous
release):
   - customization build get
   - customization build list
   - customization build logs

Backstage guide — Fixed a stale customization build list example in the
dhictl CLI tab that still used the old two-argument format; updated to
`<customization-id>` with a note on how to retrieve it.

## 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-07-27 08:07:34 -07:00
Allie Sadler
77b04c9aa8 SM go link (#25654)
<!--Delete sections as needed -->

## Description

Addresses
https://docker.slack.com/archives/C06SJCMBD9B/p1784198900169989

## 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-07-27 10:34:34 +01:00
David Karlsson
0a45349845 sbx: SSH and app integrations (#25557)
## What

Stubs a new **Integrations** section under
`content/manuals/ai/sandboxes/` documenting how to connect external
editors and
apps to a sandbox over SSH.


https://deploy-preview-25557--docsdocker.netlify.app/ai/sandboxes/integrations/

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

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-24 13:12:53 +02:00
Alexa Kristensen
3448dcdcda Revert "docs: add Enterprise Data API reference and usage reports guide" (#25632)
Reverts docker/docs#25383
2026-07-23 11:59:20 -05:00
cassio-paesleme
a2d3787389 docs: add Enterprise Data API reference and usage reports guide (#25383)
## Summary

- Adds OpenAPI 3.0 spec and API reference page for the Docker Enterprise
Data API at `/reference/api/enterprise-data/`
- Adds feature guide for enterprise usage reports at
`/manuals/enterprise/reports/`

## Context

Docker Enterprise subscribers will be able to programmatically export
organization usage reports (pull data) via
`api.docker.com/enterprise-data/v1/`. This is a new API surface,
separate from the Hub API, supporting both PAT and OAT authentication.

Related PRs:
- API implementation:
[docker/data-platform#817](https://github.com/docker/data-platform/pull/817)
- FGA scope for OAT auth:
[docker/iam-services#1029](https://github.com/docker/iam-services/pull/1029)

## New pages

| Path | Description |
|---|---|
| `/reference/api/enterprise-data/api.yaml` | OpenAPI 3.0 spec (4
endpoints: list types, list reports, download, schema) |
| `/reference/api/enterprise-data/index.md` | API reference landing page
|
| `/manuals/enterprise/reports/_index.md` | Feature guide with auth
setup, curl walkthrough, pagination, troubleshooting |

## Test plan

- [ ] API reference renders correctly at
`/reference/api/enterprise-data/`
- [ ] Feature guide renders in the Enterprise sidebar
- [ ] curl examples are copy-pasteable and accurate


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

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Alexa <alexa.kristensen@docker.com>
2026-07-23 11:26:34 -05:00
Alexa Kristensen
bc69d640a0 Connections (#25336)
MVP docs ready for final review for beta release. Outside of scope at
this time are troubleshooting docs, which will be added post GA (agreed
upon with PM + team).

---------

Co-authored-by: Greg Mondello <72952982+gmondello@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2026-07-21 13:07:55 -05:00
Gavin
04ce4626e8 docs: add redirect for Windows installation modes (#25609)
<!--Delete sections as needed -->

## Description

Adds a permanent redirect to our 'windows installation modes' docs, so
that we can link to it from Docker Desktop.

## 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-07-21 09:35:08 +01:00
Allie Sadler
64f919ca59 engdocs-3347 (#25573)
<!--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-07-15 13:59:20 +01:00
Johannes Großmann
60cddbcd6c docs(secrets): note compose build not yet supported 2026-07-15 12:45:11 +02:00
Johannes Großmann
367d9ed508 docs(secrets): add repo setup step to docker pass install 2026-07-15 09:26:51 +02:00
David Karlsson
0086211fab docs: remove docker sandbox DD plugin (removed in DD 4.80.0) (#25556)
## Summary

The `docker sandbox` Docker Desktop plugin was fully removed in Docker
Desktop 4.80.0. This PR:

- Deletes `content/manuals/ai/sandboxes/docker-desktop.md`
- Deletes all 21 CLI reference YAML files under `data/cli/sandbox/`
- Updates `content/manuals/retired.md` to say the feature was removed
(not just deprecated), with a pointer to `sbx`
- Updates `content/manuals/ai-overview.md` to show `sbx` as the CLI
command instead of `docker sandbox`

Generated by Claude Code

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-14 14:07:36 +02:00
David Karlsson
ee7c636bf2 docs: remove deprecated docker sandbox (Docker Desktop plugin)
The `docker sandbox` Docker Desktop plugin was fully removed in Docker
Desktop 4.80.0. Remove the dedicated docs page, all CLI reference YAML
files, and update the retired products page to reflect removal rather
than deprecation. Update the AI overview table to reference `sbx`.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-14 08:16:41 +02:00
Johannes Großmann
70344e754f docs(secrets): add installation instructions for docker pass 2026-07-13 14:52:53 +02:00
Craig Osterhout
27e3346a3a sbx: sync cli ref for 0.35.0 (#25532)
<!--Delete sections as needed -->

## Description

Syncs all CLI reference YAML files in `data/sbx_cli/` from
`docker/sandboxes` at the v0.35.0 tag.

### New commands

| Command | Notes |
|---------|-------|
| `sbx daemon start/stop/status/log-level` | Manage the sandbox daemon
directly |
| `sbx policy check network` | Test whether the current policy would
allow a request |
| `sbx policy inspect` | Inspect a single policy or rule (replaces `sbx
policy show`) |
| `sbx secret import` | Import credential env vars into the keychain |

### Updated commands

| Command | What changed |
|---------|--------------|
| `sbx rm` | New `--force` flag for active sessions |
| `sbx policy ls` | New `--wide`, `--source`, `--decision` filters;
updated output format |
| `sbx policy` | Updated `see_also` to list new subcommands |
| `sbx secret` | Updated `see_also` to list `import` subcommand |
| `sbx kit add` | Synopsis and description reflect swap-recreate
behavior |

## 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: Craig Osterhout <craig.osterhout@docker.com>
2026-07-10 10:44:45 -07:00
Craig Osterhout
fdb2746edc scout: feature updates (#25500)
<!--Delete sections as needed -->

## Description


https://deploy-preview-25500--docsdocker.netlify.app/scout/policy/

https://deploy-preview-25500--docsdocker.netlify.app/scout/release-notes/platform/
https://deploy-preview-25500--docsdocker.netlify.app/retired/

## Related issues or tickets

ENGDOC-3311

## 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-07-06 09:24:07 -07:00
Allie Sadler
43903a98a6 redirect fix (#25497)
<!--Delete sections as needed -->

## Description

as per 
https://docker.slack.com/archives/C0W4XJVFW/p1783076173021609

## 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-07-06 11:58:53 +01:00
Allie Sadler
159fa357d8 Compose: init containers (#25435)
<!--Delete sections as needed -->

## Description

As per https://github.com/docker/compose/pull/13862 and
https://github.com/compose-spec/compose-spec/pull/647

## 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

---------

Co-authored-by: Guillaume Lours <705411+glours@users.noreply.github.com>
2026-07-02 12:44:12 +01:00
David Karlsson
f02e2a5633 Revamp the guides section: taxonomy, single-page structure, and new landing/filter UX (#25338)
## What

A full revamp of the `/guides` section — taxonomy, structure, and UX.

Preview: https://deploy-preview-25338--docsdocker.netlify.app/guides/

### Taxonomy & structure
- Replaces the sprawling 24-tag set with a focused 9-tag taxonomy
aligned to use case / SDLC: **Languages & frameworks, AI, Testing,
CI/CD, Security, Databases, Deployment, Admin, Hands-on labs**.
- Removes the languages taxonomy entirely (`data/languages.yaml` and all
`languages:` front matter).
- Collapses all multi-page guide series into single pages, with aliases
so old sub-page URLs continue to resolve.
- Deletes redirect-only shim pages and flattens directory-wrapped single
pages.

### Landing page (`/guides/`)
- A clean index: hero, then category sections listing each guide as a
plain **title / summary** row.
- **Browse rail** (sticky, left): click a topic to filter the page to
just that topic's guides; "All guides" resets. A count + Clear bar
appears while filtering.
- **Text filter**: instant client-side search over title, summary, and
tags. Topic filter and text search are mutually exclusive and share the
same flat-list view.
- No more "Featured guides" section.

### Guide content pages
- Removes the left sidebar for the guides section (mobile drawer kept).
- Centered reading column (`92ch`) with the TOC taking the remaining
width.
- Summary rendered as a lead paragraph under the h1.
- TOC scrollbar auto-hides until hover; breadcrumbs render at a
consistent size inside and outside `prose`.

## Notes
- Deep full-text search across guide bodies is still handled by the
existing site-wide Pagefind (⌘K); the landing filter is the fast
metadata-narrowing surface.
- `series.html` is retained — it's still used by `get-started` pages.

## Validation
- Site builds clean locally (Hugo dev server, no errors / broken refs).
- All collapsed sub-page URLs redirect via aliases.

## Follow-ups

- Prune guides that we no longer need/want
- Tighten the guides that span too many concepts (e.g. language guides;
remove cicd/deploy/sscs)

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-01 10:47:10 +02:00
David Karlsson
d8666ddbaf sbx: vendor v0.34.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-06-29 16:17:45 +02:00
Allie Sadler
090e878e60 Add go links (#25429)
<!--Delete sections as needed -->

## Description

## 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-24 14:01:38 +01:00
Allie Sadler
5cba44ed0c update go links for desktop (#25409)
<!--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-22 14:19:21 +01:00
github-actions[bot]
a5aad9d311 cli: sync docs with docker/cli v29.6.0 2026-06-20 03:18:48 +00:00
docker-tools-robot
53289c5030 vendor: github.com/docker/buildx v0.35.0
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-06-18 01:20:48 +02:00
David Karlsson
d20aca1414 docs(sandboxes): vendor v0.33 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-06-17 09:51:04 +02:00
Johannes Großmann
15928d9f8b feat(docker-pass): update docs 2026-06-10 10:14:44 +02:00
David Karlsson
e92bd0bfb4 sbx: vendor v0.32.0 CLI reference
Update the vendored sbx CLI reference data for v0.32.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-05 14:36:24 +02:00
github-actions[bot]
7709050a8b cli: sync docs with docker/cli v29.5.3 2026-06-04 03:22:04 +00:00
David Karlsson
9ac9c0cd36 Merge pull request #25175 from joe0BAB/feat/pass-v2
feat(docker-pass): update docs
2026-06-03 12:41:47 +02:00
Johannes Großmann
f47ca30b56 feat(docker-pass): update docs 2026-06-03 12:13:36 +02:00
Craig Osterhout
b3fe4b8ca9 dd: add go redirect (#25213)
<!--Delete sections as needed -->

## Description

Adds go redirect for desktop release notes.

## Related issues or tickets

https://docker.slack.com/archives/C04300R4G5U/p1780079286850999

## Reviews

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

- [ ] Editorial review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-05-29 19:47:55 +00:00
David Karlsson
888b4d19ff sbx: vendor v0.31.0 cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-05-28 22:10:19 +02:00
Craig Osterhout
2ea4a02305 dhi: update cli ref (#25163)
<!--Delete sections as needed -->

## Description

Updated DHI CLI to v0.0.4 that adds `docker dhi auth deb`.

https://github.com/docker-hardened-images/dhictl/releases/tag/v0.0.4


https://deploy-preview-25163--docsdocker.netlify.app/reference/cli/docker/dhi/auth/

## 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-05-26 07:56:15 -07:00
David Karlsson
9b1780fba0 Merge pull request #25102 from dvdksn/dvdksn/sbx-cli-reference-updates
Update sbx CLI reference data
2026-05-25 17:01:00 +02:00
David Karlsson
7745dfd77c Merge pull request #25063 from dvdksn/gordon-ga
gordon: GA release documentation updates
2026-05-19 20:51:01 +02:00
David Karlsson
e613d0ffc9 Update sbx CLI reference data
Add sbx kit subcommand references and update policy/login/ports/rm/secret
command descriptions and option documentation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-19 17:05:54 +02:00
David Karlsson
30e29c32e3 gordon: GA release documentation updates
- Remove Beta badge and availability marker; Gordon is now GA
- Update subscriber note: available to all Docker accounts, Business
  admins control access via Admin Console (no longer requires Support contact)
- Replace "Beta features" settings path with "AI" section across all pages
- Add usage-limits.md covering Base/Plus/Max/Ultra plans, approximate
  question limits per time window, usage indicator, and docs.docker.com Gordon
- Document contextual help entrypoints from Containers, Images, and Builds views
- Document usage indicator in Docker Desktop

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-05-19 10:34:20 +02:00
github-actions[bot]
5bfad3013a cli: sync docs with docker/cli v29.5.0 2026-05-16 03:16:49 +00:00
David Karlsson
bc1f318dfa Merge pull request #24978 from dvdksn/docs/sbx-scoped-kit-policies
Document scoped network policies for sbx
2026-05-14 16:18:02 +02:00
crazy-max
d4470c4015 vendor: github.com/docker/buildx v0.34.0
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-05-13 14:54:03 +00:00
David Karlsson
f01a8cbe9c docs: document sandbox-scoped kit network policies
Kit network policy docs did not cover sandbox-scoped rules or kit-level deniedDomains.

Update the Sandboxes policy and kits pages with scoped policy examples, deniedDomains guidance, and a small policy page formatting fix.

Co-Authored-By: Codex <noreply@openai.com>
2026-05-13 08:17:20 +02:00
David Karlsson
56446aabea docker agent: drop experimental label
Remove the sidebar "Experimental" badge and the summary-bar shortcode
from the Docker Agent landing page, and drop the corresponding entry
from data/summary.yaml. The A2A protocol note in the CLI reference
stays scoped to that sub-feature.
2026-05-12 15:23:01 +02:00
Nick Adcock
c0aa985ff8 Mark Autobuilds feature as deprecated (#24981)
<!--Delete sections as needed -->

## Description

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

Marks Docker Hub Automated Builds (Autobuilds) as a deprecated feature
to be retired on Apr 1st 2027

## 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: Nick Adcock <nick.adcock@docker.com>
2026-05-07 07:56:32 -07:00
Allie Sadler
8fcf6b97d1 Logs GA (#24904)
<!--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-05-06 12:37:46 -05:00