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

4238 Commits

Author SHA1 Message Date
David Karlsson
abbd077fd4 docs: document sandbox SSH forwarding 2026-04-28 19:19:18 +02:00
David Karlsson
3b55a073d8 Merge pull request #24910 from dvdksn/sbx/cp
Document sbx cp
2026-04-28 19:16:48 +02:00
David Karlsson
0d7edfae5f Merge pull request #24917 from dvdksn/sbx/rm-experimental
Deprecate Docker Desktop sandboxes
2026-04-28 18:19:10 +02:00
David Karlsson
e13cbed7a8 docs: deprecate Docker Desktop sandboxes
Docker Desktop sandboxes and docker sandbox CLI reference pages needed to be marked deprecated while removing sbx experimental callouts.

Updated sandbox docs, retired products listing, and sandbox CLI metadata so the deprecated state is reflected consistently.

Generated by Codex

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-28 18:14:19 +02:00
David Karlsson
1a4d0ea4a5 Merge pull request #24886 from dvdksn/docs/buildx-k8s-pvc-cache
docs: add k8s driver PVC cache option
2026-04-28 12:06:45 +02:00
Britney Blodget
abfb1afec8 Clarify mirroring permissions and access tokens (#24890)
Updated permissions information for organization access tokens.

<!--Delete sections as needed -->

## Description

[slack
thread](https://docker.slack.com/archives/C0989V6TAK0/p1776941317779569)

## 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>
Co-authored-by: Craig Osterhout <craig.osterhout@docker.com>
2026-04-27 15:17:51 -07:00
David Karlsson
1cda2e3849 docs: add sbx cp reference 2026-04-27 19:32:42 +02:00
Craig Osterhout
5d19e41fe8 dhi: add vex status and refresh (#24838)
<!--Delete sections as needed -->

## Description
- Adds VEX status reference and `not_affected` justification codes based
on OpenVEX and usage in the advisory repo.
- Adds "Why DHI does not use `fixed`"
- Removes "Why is VEX important?" and "How DHI integrates VEX" sections.
This content is covered more concretely in `scanner-integrations.md`.
Will follow up to figure out how to cover the content better between
these two topics, but removing redundant content for now.


https://deploy-preview-24838--docsdocker.netlify.app/dhi/core-concepts/vex/

## Related issues or tickets

ENGDOCS-3238

## Reviews

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

- [ ] Technical review
- [ ] Editorial review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-04-27 08:34:21 -07:00
Allie Sadler
f7686b3572 4.71 RN (#24846)
<!--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-04-27 08:52:05 +01:00
David Karlsson
1f1df424c5 Merge pull request #24901 from dvdksn/fix/home-markdown-output
fix/home markdown output
2026-04-27 09:05:23 +02:00
Craig Osterhout
93c783b822 guides: update dotnet (#24810)
<!--Delete sections as needed -->

## Description

Tested and updated the dotnet guide.
 - Add missing stage name for dhi Dockerfile
 - Clean up some output

## 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-24 17:59:34 -05:00
David Karlsson
6fe2b1154d Add markdown output for docs homepage 2026-04-24 15:00:46 +02:00
Alexa Kristensen
26ea39ec33 Agent redirect skill and small admin > company reorg (#24856)
This PR captures a small chunk of work intended to test a new agent
skill for handling redirect aliases, link references, and link anchors.
2026-04-24 07:50:35 -05:00
JC Grünhage
891c1d7c7b build: git remote authentication secrets (#23460)
## Description
I fixed the documentation, because it was wrong. See the issues and
buildkit PR for details.

## Related issues or tickets

- BuildKit issue: https://github.com/moby/buildkit/issues/5703
- Docs issue: https://github.com/docker/docs/issues/22834
- Another BuildKit issue: https://github.com/moby/buildkit/issues/6046
- PR that introduced the behaviour:
https://github.com/moby/buildkit/pull/1533
- PR that introduced the docs: https://github.com/docker/docs/pull/19739

## Reviews

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

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

---------

Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-24 10:42:48 +02:00
David Karlsson
d6a37d512e docs: add k8s driver PVC cache option
The Kubernetes driver page did not describe the new persistent-volume-claim.requests.storage option added in Buildx.\n\nDocument the option, explain that it switches the workload to a StatefulSet, and show that it persists the build cache per replica.
2026-04-24 09:50:30 +02:00
Louis-Arnaud
95fff41cc2 docs: clarify SLES s390x scope in engine install platform table (#24863)
The platform table on `engine/install/_index.md` listed `SLES` with an ❌
in the s390x column, which reads as if SLES is unsupported in general.
The linked `sles.md` is actually scoped to SLES on s390x (the page's own
`linkTitle` is already `SLES (s390x)`).

Align the table label with the page's `linkTitle` so the
architecture-specific scope is visible without clicking through.

Fixes #24862
2026-04-24 08:39:21 +02:00
David Karlsson
9215dff0bb Merge pull request #24885 from nielskaspers/docs/issue-24882-fix-service-users-link
docs: fix broken link to service users section in link-source.md
2026-04-24 08:36:52 +02:00
David Karlsson
dcc77fbc9d Merge pull request #24884 from nielskaspers/docs/issue-24881-fix-regexes-links
docs: fix broken cross-references to regexes section in setup.md
2026-04-24 08:36:41 +02:00
David Karlsson
538af9ba28 Merge pull request #24879 from Rohan5commit/docs/extensions-sdk-material-ui-wording-20260424
docs: fix extension SDK wording
2026-04-24 08:36:00 +02:00
Niels Kaspers
7a88446055 docs: fix broken link to service users section in link-source.md
The 'Service users for team autobuilds' section lives in setup.md,
not in _index.md. Point the 'create a service account' link to
setup.md#service-users-for-team-autobuilds so it resolves correctly.
2026-04-24 09:28:45 +03:00
Niels Kaspers
3d5ba4c5f2 docs: fix broken cross-references to regexes section in setup.md
Two links pointed to index.md#regexes-and-automated-builds, but the
'Regexes and automated builds' section lives in setup.md itself.
Use same-file anchors so the links resolve correctly.
2026-04-24 09:27:39 +03:00
Codex
a603c7fdfd docs: avoid first-person wording in extension SDK docs 2026-04-24 11:28:15 +08:00
Codex
cf67bb4e79 docs: refine extension SDK wording 2026-04-24 11:22:00 +08:00
Codex
6e6b26c518 docs: fix automated builds grammar 2026-04-24 11:18:38 +08:00
Codex
446e914b24 docs: fix extension SDK wording 2026-04-24 11:18:31 +08:00
Craig Osterhout
3586ba5715 guides: add django (#24851)
<!--Delete sections as needed -->

## Description

Added simple Django guide. 

https://deploy-preview-24851--docsdocker.netlify.app/guides/django/

## Related issues or tickets

Closes #21277

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-04-23 13:53:33 -07:00
David Karlsson
8f6948bebe Merge pull request #24865 from dvdksn/fix/sbx-ubuntu-prereq
sbx: ubuntu requires 24.04 or later
2026-04-23 20:20:08 +02:00
Alexa Kristensen
3619fb1780 Admin IA refresh (#24852)
PR to capture work:

- Update / simplify titles to match docs
- Create subcategories within org/company
- Wrestle with redirect nightmare part 2

Filing a follow up PR to create parallel structure in the `Company`
subcategory. This PR's scope is for `Organization` only.
2026-04-23 07:30:04 -05:00
David Karlsson
cf1c901889 sbx: ubuntu requires 24.04 or later
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-23 10:52:25 +02:00
Louis-Arnaud Catoire
33d94e3011 docs: remove contradictory auto-start note in install guides 2026-04-23 10:48:12 +02:00
Craig Osterhout
acc5a3ee3d dvp: change to vendor neutral wording (#24858)
<!--Delete sections as needed -->

## Description

Removed vendor-specific wording but kept the spirit of it.

## Related issues or tickets


## 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-04-23 08:34:26 +02:00
Craig Osterhout
490c49a7fa dhi: add bulk customization (#24850)
<!--Delete sections as needed -->

## Description

Added bulk customization for UI.

## Related issues or tickets

ENGDOCS-3234

## 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-04-22 08:51:49 -07:00
Allie Sadler
cb207912e0 diagnose fix (#24855)
<!--Delete sections as needed -->

## Description

closes https://github.com/docker/docs/issues/24854

## 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-04-22 09:30:04 +02:00
Niels Kaspers
53014a8163 docs(scout): standardize CLI command to docker scout in CI guides (#24844)
## Summary
Standardize the Docker Scout CLI command on `docker scout` (with space)
across the CircleCI and Jenkins integration guides so it matches the
format used in `azure.md`, `gitlab.md`, and the rest of the Scout docs
(`install.md`, `quickstart.md`, `gha.md`).

## Issue
Fixes #24843

## Changes
- `content/manuals/scout/integrations/ci/circle-ci.md`: change
`docker-scout cves …` to `docker scout cves …`
- `content/manuals/scout/integrations/ci/jenkins.md`: change
`docker-scout cves …` to `docker scout cves …`

Other references to `docker-scout` that are not CLI invocations (the
binary filename in `install.md`, the GitHub Action step `id:
docker-scout` in `gha.md`, external URLs, and Azure resource names) are
intentionally left unchanged.

## Testing
- Docs-only change. Diff is two lines, no content rewrites.

Signed-off-by: Niels Kaspers <kaspersniels@gmail.com>
2026-04-21 09:51:55 -07:00
David Karlsson
12124ee595 Merge pull request #24759 from dvdksn/sbx/factory-ai
sbx: add factory-ai (droid) agent
2026-04-21 10:06:39 +02:00
Allie Sadler
fec17b6a56 ENGDOCS-3240 (#24830)
<!--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-04-21 07:41:56 +01:00
Sebastiaan van Stijn
0ef8955d81 Merge pull request #24833 from vvoland/update-docker
engine: 29.4.1
2026-04-20 20:00:56 +02:00
dmitry-bychkov
aca1dd86d7 Update Dockerfile code snippet for "Using the official Docker image" tab (#24820)
The code snippet for Dockerfile under the "Using the official Docker
images" contains a comment which says that this Docker file uses DHI
image, which is incorrect.

<!--Delete sections as needed -->

Updated the code snippet to match the tab contents 

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-04-20 10:54:34 -07:00
Louis-Arnaud
6be4c12b27 docs: clarify DHI build auth requirement context (#24835)
Fixes #24818.

The `[!IMPORTANT]` callout at the top of
`content/manuals/dhi/how-to/build.md` read:

> You must authenticate to the Docker Hardened Images registry
(`dhi.io`) to pull base images and build tools. [...]

Phrased that way it reads as if any Dockerfile using a DHI base image
(e.g. `FROM dhi.io/python:3.13`) needs a special authentication step
specific to the build page. The real reason is scoped: the DHI build
frontend itself pulls from `dhi.io` when processing a YAML definition
file.

Rewritten to tie the requirement explicitly to the DHI build system and
to the act of building a definition file, so readers don't extrapolate
the requirement to unrelated Dockerfile usage. Wording around the Docker
ID credentials is preserved.
2026-04-20 10:48:54 -07:00
Louis-Arnaud
0194389f36 docs: clarify OCI artifact ordering in DHI customize Docker Hub flow (#24836)
Fixes #24819.

In `content/manuals/dhi/how-to/customize.md` the Docker Hub tab jumped
from "select the repository / select the tag" straight to "images later
in the list will overwrite files from earlier images" without first
establishing that multiple OCI artifacts can be added or how their
ordering is determined in the UI. Readers understood the consequence but
not the mechanism.

Adds one short paragraph before the overwrite rule to anchor the reader:

- multiple OCI artifacts can be added to a single customization,
- they're applied in the order they're added in the **OCI artifacts**
drop-down.

The overwrite rule is rephrased to:

- refer to "images added later / images added earlier" for consistency
with the new paragraph,
- use "If multiple images contain directories or files with the same
path" (the rule applies to any N≥2, not just two),
- use "directories or files" instead of the existing "directories and
files", which could be read as requiring both types in the same artifact
for the rule to apply.

No change to the subsequent paragraphs about include/exclude paths.
2026-04-20 10:41:54 -07:00
Paweł Gronowski
20456cf954 engine: 29.4.1
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-04-20 18:50:00 +02:00
Louis-Arnaud
f90409007b docs: align DHI Python migration example auth note with Go and Node (#24834)
Fixes #24743.

The authentication note at the top of
`content/manuals/dhi/migration/examples/python.md` was the stripped-down
version, missing:

- the indication that `docker login dhi.io` expects Docker ID
credentials
- the detail that those are the same credentials as Docker Hub
- the link to the account creation page

The equivalent notes in `go.md` (lines 24-29) and `node.md` (lines
24-29) carry all three. This PR copies the full paragraph into
`python.md` so Python readers get the same onboarding guidance.

No other content changed.
2026-04-20 09:17:05 -07:00
David Karlsson
f2eccfe389 sbx: add droid agent
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-20 17:28:32 +02:00
Alexa Kristensen
4c4c51b013 fast follows (#24832)
Fast follow ups:

- Returned aliases with new alias to one doc
- Updated provision index page to accurately reflect different methods
- reorganized table to reflect popularity of methods based off sme info
(scim is the vogue, then JIT, then auto provision)
  - Updated grid to link correctly to auto provisioning doc
- Created more opinionated left nav to reflect recommendations around
security SCIM > JIT > auto
- Fixed `*`s to be `-`s
- Updated Migrate doc heading levels
2026-04-20 10:16:44 -05:00
David Karlsson
60fdb3cbfe Merge pull request #24746 from dvdksn/docs/sbx-linux-state-paths
Add Linux state paths to troubleshooting
2026-04-20 16:12:26 +02:00
Allie Sadler
1acfdfcad1 4.70 RN (#24717)
<!--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

---------

Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-04-20 14:53:47 +01:00
Louis-Arnaud
1043de9461 engine/install: document iptables alternative on Fedora (#24811)
Adds a troubleshooting note on the Fedora install page for the case
where the Docker service fails to start with `failed to find iptables`
in the logs, pointing users to set the `iptables` alternative to
`iptables-nft`.

Closes #23186
2026-04-20 15:49:00 +02:00
Mahitha Adapa
1ad73ff812 Add network_mode: bridge to Compose file reference (#24749)
<!--Delete sections as needed -->

## Description

Adds documentation for `network_mode: bridge` in the Compose file
reference.

While `bridge` is a valid and functional network_mode option that
connects
containers to the host's default bridge network, it was not documented
alongside the other options (none, host, service, container).

Fixes #24742.

- #24742

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

## Reviews

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

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

---------

Signed-off-by: Mahitha Adapa <mahitha.ada@gmail.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2026-04-20 14:48:44 +01:00
David Karlsson
1c05501498 Merge pull request #24815 from lacatoire/fix/issue-21898-json-file-compress-default
engine/logging: fix json-file compress default value
2026-04-20 15:47:24 +02:00
Alexa Kristensen
6d61abd2a8 SCIM jit edits (#24600)
just a lot of stuff that got out of hand idk. it started out as a nice
reorg of provision and turned into a nightmare of my own making
2026-04-20 08:44:44 -05:00