Commit Graph

65350 Commits

Author SHA1 Message Date
Mathieu Champlon
b5972acff1 Fix msiexec invocation quotes (#23431)
## Description

Fixes the quotes in an installation example command line.

- [ ] Technical review
2025-09-23 07:41:52 +01:00
Michael Irwin
e346b0bcf2 Add a guide for adding pgAdmin to to application stack (#23441)
## Description

Created a new guide that walks users through adding pgAdmin to their
application stack to visualize a PostgreSQL database. Also includes
details on how to auto-connect to the database using Compose config
files.

## Related issues or tickets

None

## Reviews

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

Would appreciate an editorial review, specifically on the usage of
italics/bold around step #4. I believe I followed the editing guidelines
correctly, but a second pair of eyes wouldn't hurt.

Thanks!

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-09-22 11:30:25 -07:00
Usha Mandya
a57178aa15 Merge pull request #23440 from usha-mandya/dmr-get-started-patch
Fix incorrect cross-reference and repetitive headings
2025-09-22 18:28:00 +01:00
Craig Osterhout
466db49326 update nav dropdown behavior (#23436)
<!--Delete sections as needed -->

## Description

Change how the section drop-down arrows are rendered in the side-nav.

Currently, they generate for any folder, even if it just contains an
index. To not generate the arrow, the index would have to be taken out
of the folder and renamed as the folder.

This change now counts how many children under the index, and only
generates the arrow if it has children (that aren't hidden from the
nav).

For example, see how there is an arrow for the mcp gateway, but it
expands to nothing.
Current: https://docs.docker.com/ai/mcp-gateway/
Updated:
https://deploy-preview-23436--docsdocker.netlify.app/ai/mcp-gateway/

## 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 <craig.osterhout@docker.com>
2025-09-22 08:00:15 -07:00
Usha Mandya
f4f34275b2 Fix incorrect cross-reference and repetitive headings
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2025-09-22 11:26:51 +01:00
JPBotelho
2c0d6fd792 fix: typos (#23435)
<!--Delete sections as needed -->

## Description

Fixed typos

## 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
2025-09-19 16:05:53 -07:00
Vincent DAMERY
479e7dcf5c [docker-hub-api] Add Create, Get, Head repository endpoint (#23428)
<!--Delete sections as needed -->

## Description

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

Add `Create repository` endpoint

## Related issues or tickets

<!-- 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
2025-09-19 10:27:11 -04:00
Sarah Sanders
4a666fcc18 fix: rss feed template (#23419)
## Description
- Improvement to RSS feed, add single items for each release item
- This approach requires data .yaml files to keep things clean, Hugo
doesn't output RSS well with just parsing HTML and headings

## Preview
-
https://deploy-preview-23419--docsdocker.netlify.app/desktop/release-notes/index.xml
-
https://deploy-preview-23419--docsdocker.netlify.app/security/security-announcements/

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2999
2025-09-19 10:07:14 -04:00
Junho Lee
13b71a0db8 Doc: update install guide (#23423)
## Description

As seen in the [PR](https://github.com/docker/docs/issues/23244), the
current documentation suggests the installation command might cause
confusion in some scenarios. To ensure clarity and make the process more
robust, I suggest updating the command as follows:

Before
```
mv ./docker /usr/local/bin
```

After
```
cp -rp ./docker /usr/local/bin/ && rm -r ./docker
```

I believe this will help users and improve the clarity of the
instructions.

Thank you for considering this change! :)

## Related issues or tickets

#23244 

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-09-19 09:44:24 +01:00
Lorena Rangel
92b2e9ba9b Update correct link to Linux issue tracker (#23427)
<!--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
2025-09-19 09:42:47 +01:00
Craig Osterhout
e355c741da dhi: update mirror example (#23392)
<!--Delete sections as needed -->

## Description

Combined mirroring image and attestations into one command to minimize
user error.

https://deploy-preview-23392--docsdocker.netlify.app/dhi/how-to/mirror/#example-mirroring-with-regctl

## Related issues or tickets

Follow up to #22879


https://docker.slack.com/archives/C04M34MRQS1/p1757501134275029?thread_ts=1756743027.065479&cid=C04M34MRQS1

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-18 08:03:17 -07:00
Guillaume Lours
7fbf498277 add description of 'initial_sync' attribute in Compose watch documentation (#23421)
<!--Delete sections as needed -->

## Description
Describe the new added `initial_sync` attribute of Compose watch
configuration

## Related issues or tickets
Fix #23345

## Reviews

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

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

---------

Signed-off-by: Guillaume Lours <705411+glours@users.noreply.github.com>
Co-authored-by: aevesdocker <allie.sadler@docker.com>
2025-09-18 10:54:30 +01:00
Tadashi Nemoto
67e9f7bf4d Update offload optimize.md (#23415)
`###` should be `##`

<!--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
2025-09-17 09:59:42 -07:00
Allie Sadler
09af49ea6b faq fix (#23416)
<!--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
2025-09-17 10:08:26 +01:00
Laurent Goderre
040f6afeea dhi: add guide to use in Kubernetes (#23393)
## Description

dhi: add guide to use in Kubernetes. For now, this only covers image
pull secrets.

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-09-16 08:00:48 -07:00
Austin Vazquez
58f08039d3 engine/install: add note for service start on deb flavors (#23405)
## Description

This change is to address some feedback from a Ubuntu user that
installed Docker Engine using the apt repository but had to start the
service before they were able to run containers.

While autostart is the convention on Debian systems, some users might
have this behavior disabled for more fine grained control. This change
adds a note to the installation step across all the debian flavors to
note the service should start by default with explicit instructions how
to enable the service if not.

## Related issues or tickets

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

## Reviews

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

- [ ] Technical review - @vvoland
- [ ] Editorial review - @usha-mandya 
- [ ] Product review

Signed-off-by: Austin Vazquez <austin.vazquez@docker.com>
2025-09-16 09:35:38 +01:00
Usha Mandya
af160beff0 Merge pull request #23403 from usha-mandya/mcp-banner-update
Update landing page to include MCP Toolkit banner and card
2025-09-15 18:11:16 +01:00
Craig Osterhout
336aab878b get-started: fix typo (#23406)
<!--Delete sections as needed -->

## Description

Fixed typo.

## Related issues or tickets

https://docker.slack.com/archives/C04BMTUC41E/p1757683181769229

## Reviews

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

- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-15 08:17:34 -07:00
Allie Sadler
4d3913fcf1 SM: settings reference tidy (#23412)
<!--Delete sections as needed -->

## Description

Updates the DD settings reference page

## 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
2025-09-15 15:35:15 +01:00
Usha Mandya
a0142e9938 Merge pull request #23401 from usha-mandya/engdocs-2993
Add a note on DCT retirement
2025-09-15 09:33:44 +01:00
Usha Mandya
49dc2a288b Update the landing page to include MCP Toolkit banner and card
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2025-09-12 16:51:09 +01:00
Usha Mandya
13638dc820 Add a note on DCT retirement
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2025-09-12 10:40:13 +01:00
Allie Sadler
2ddbdf9095 chore: RN link (#23400)
<!--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
2025-09-12 10:21:53 +01:00
Allie Sadler
27bf9b9637 chore: build url query summary bar (#23397)
<!--Delete sections as needed -->

## Description
small follow-up to https://github.com/docker/docs/pull/23322
## 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
2025-09-12 10:06:12 +01:00
Craig Osterhout
61380908f2 dhi: add single stage migration examples (#23384)
<!--Delete sections as needed -->

## Description

Added single-stage migration examples to inform the user that it is
possible, but noted the tradeoff.

https://deploy-preview-23384--docsdocker.netlify.app/dhi/how-to/migrate/

## Related issues or tickets

ENGDOCS-2972

## Reviews

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

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

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-11 08:41:42 -07:00
george
4658398187 remove irrelevant release note (#23396)
This one accidentally made it from the previous release into this one
2025-09-11 16:10:20 +01:00
Akihiro Suda
741679e3dc build: document URL queries (#23322)
<!--Delete sections as needed -->

## Description

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

BuildKit v0.24 introduces URL like
`https://github.com/example/example.git?tag=v0.0.1&checksum=deadbeef`

## Related issues or tickets

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

- https://github.com/moby/buildkit/pull/6172
- https://github.com/moby/buildkit/pull/6173

## Reviews

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

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

---------

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
Signed-off-by: CrazyMax <1951866+crazy-max@users.noreply.github.com>
Co-authored-by: CrazyMax <1951866+crazy-max@users.noreply.github.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2025-09-11 15:58:53 +01:00
Allie Sadler
91bf53e779 DD 4.46 release (#23394)
<!--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

<!--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: Usha Mandya <usha.mandya@docker.com>
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
2025-09-11 15:53:51 +01:00
Allie Sadler
41aebb79fc DD: 4.46 RN (#23372)
<!--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
2025-09-11 15:49:58 +01:00
Craig Osterhout
b67e13f6f5 dhi: update mirroring example (#22879)
<!--Delete sections as needed -->

## Description

Updated mirroring example.
- Removed Docker CLI example of mirroring the image as it just mirrors
the image.
  - Added example of using regctl and regsync


https://deploy-preview-22879--docsdocker.netlify.app/dhi/how-to/mirror/#mirror-from-docker-hub-to-another-registry

## Related issues or tickets

ENGDOCS-2752

## Reviews

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

- [ ] Technical review
- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-10 08:18:28 -07:00
Kristiyan Velkov
c15aa40f28 [feat] increare the docker base images for node.js, nginx for sample projects angular, react.js, vue.js (#23388)
## Description

This PR updates the Docker build arguments for all front-end project
guides (React.js, Angular, Vue.js) to use the latest Node.js and NGINX
versions for improved security, stability, and performance.

### Changes Made

- Updated Node.js version: From 22.14.0-alpine → 24.7.0-alpine
- Updated NGINX version: From alpine3.21 → alpine3.22

### Impact

- Ensures projects are built on the latest stable Node.js runtime
without security issues.
- Provides updated NGINX base image for better performance and security
patches.
- Aligns Docker images across React.js, Angular, and Vue.js guides with
consistent and up-to-date configurations.

- [x] Technical review
2025-09-10 16:00:23 +01:00
Craig Osterhout
5d7168c9a5 engine: format using code fence (#23385)
<!--Delete sections as needed -->

## Description

Formatted codeblocks with code fence to prevent styling issue.
Cleaned up some spacing.


https://deploy-preview-23385--docsdocker.netlify.app/engine/security/trust/trust_sandbox/

## Related issues or tickets

Closes #23376 

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-10 07:59:33 -07:00
Dorin-Andrei Geman
0a34ff41d2 settings-management: DMR: fix settings name (#23387)
<!--Delete sections as needed -->

## Description

Fix Docker Model Runner settings name.

## Related issues or tickets

Follow up https://github.com/docker/docs/pull/23383.

## Reviews

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

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

Signed-off-by: Dorin Geman <dorin.geman@docker.com>
2025-09-10 10:13:37 +01:00
Usha Mandya
9bb9ef4c6b Merge pull request #23382 from usha-mandya/engdocs-2988
Update max image size section
2025-09-10 10:06:33 +01:00
Dorin-Andrei Geman
861a4f7a8d settings-management: Docker Model Runner GA (#23383)
<!--Delete sections as needed -->

## Description

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

- Added `enableInferenceGPUVariant` to the AI settings table.
- Added the Docker Model Runner settings in the `admin-settings.json`
file example.
- Mentioned the AI settings group in Docker Desktop in the settings
reference.
- Added `enableInferenceGPUVariant` in the settings reference.
- Mentioned the Admin Console for the Docker Model Runner settings in
the settings reference.

## Related issues or tickets

https://docs.docker.com/ai/model-runner/

https://docker.slack.com/archives/C02DDPKLJ0J/p1757437016971229?thread_ts=1757416342.491719&cid=C02DDPKLJ0J

## Reviews

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

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

---------

Signed-off-by: Dorin Geman <dorin.geman@docker.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Co-authored-by: Jacob Howard <jacob@xenoscopic.com>
2025-09-10 09:47:12 +01:00
Usha Mandya
40a369e786 Update max image size section 2025-09-09 18:49:00 +01:00
Marco Franzon
8158dfb501 Add Opentelemetry guide (#23187)
<!--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: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
Co-authored-by: Sarah Sanders <sarah.sanders@docker.com>
2025-09-09 09:43:03 -04:00
Guillaume Lours
8b6b538cf0 release-notes for Compose v2.39.3 version (#23375)
<!--Delete sections as needed -->

## Description
Add release notes of latest `v2.39.3` release of Compose

## Related issues or tickets
N/A

## Reviews

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

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

Signed-off-by: Guillaume Lours <705411+glours@users.noreply.github.com>
2025-09-09 11:27:45 +01:00
CrazyMax
25d172ef9e Merge pull request #23353 from docker/dependabot/github_actions/aws-actions/configure-aws-credentials-5
build(deps): bump aws-actions/configure-aws-credentials from 4 to 5
2025-09-09 10:21:24 +02:00
CrazyMax
c6fef48175 Merge pull request #23357 from docker/dependabot/github_actions/reviewdog/action-setup-1.4.0
build(deps): bump reviewdog/action-setup from 1.3.2 to 1.4.0
2025-09-09 10:20:38 +02:00
CrazyMax
fb19dd2b05 Merge pull request #23363 from docker/dependabot/github_actions/actions/labeler-6.0.1
build(deps): bump actions/labeler from 5.0.0 to 6.0.1
2025-09-09 10:20:05 +02:00
CrazyMax
612285d96b build: fix icon in drivers page (#23305)
<!--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: CrazyMax <1951866+crazy-max@users.noreply.github.com>
2025-09-09 09:13:05 +01:00
Renat
88cdf22590 Fix typo in api-reference.md: OpenAPI -> OpenAI (#23373)
## Description

It appears that there is a typo on the DMR API [documentation
page](https://docs.docker.com/ai/model-runner/api-reference/):
The section with **OpenAI**-compatible endpoints is named 'Available
**OpenAPI** endpoints'.

## Related issues or tickets:

No related issues or tickets found.

## Reviews

- [ ] Editorial review
2025-09-09 07:32:12 +01:00
Craig Osterhout
1bc8ff1032 dhi: update vex get (#23367)
<!--Delete sections as needed -->

## Description

Added new vex get command where applicable in DHI docs.

-
https://deploy-preview-23367--docsdocker.netlify.app/dhi/how-to/scan/#use-vex-to-filter-known-non-exploitable-cves
-
https://deploy-preview-23367--docsdocker.netlify.app/dhi/core-concepts/vex/#use-vex-to-filter-known-non-exploitable-cves
-
https://deploy-preview-23367--docsdocker.netlify.app/dhi/core-concepts/cves/#use-vex-to-filter-known-non-exploitable-cves

## Related issues or tickets

DHI-646

## Reviews

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

- [ ] Editorial review
- [ ] Product review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-09-08 08:27:20 -07:00
CrazyMax
4750bc5718 Merge pull request #23364 from docker/dependabot/github_actions/actions/github-script-8
build(deps): bump actions/github-script from 7 to 8
2025-09-08 16:56:46 +02:00
Allie Sadler
167c4fa1d1 bake: add pattern matching for targets input (#23360)
<!--Delete sections as needed -->

## Description

Adds https://github.com/docker/buildx/pull/3280

## 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
2025-09-08 11:14:54 +01:00
Allie Sadler
5d28e19d1c Build: GHA cache (#23365)
<!--Delete sections as needed -->

## Description

adds
7ba4da0800 (r2102395629)

## 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: CrazyMax <1951866+crazy-max@users.noreply.github.com>
2025-09-08 11:14:13 +01:00
Paweł Gronowski
2a483c2546 engine/install: SLES no longer supported (#23310)
- see: https://github.com/docker/docker-install/pull/466

## 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: Paweł Gronowski <pawel.gronowski@docker.com>
2025-09-08 10:30:04 +01:00
bri
021536bcdb Enhance examples in reference/compose-file/configs (#23185)
## Description

Reworked docker-compose configs examples slightly
2025-09-08 10:28:49 +01:00
Akihiro Suda
89344f43f1 engine/security/rootless: split to multiple pages ; remove outdated/duplicated info (#23302)
<!--Delete sections as needed -->

https://docs.docker.com/engine/security/rootless/ was too lengthy and
giving a false sense that Rootless mode was quite clunky and hard to
use, although actually it can be just set up in a single command:
```
dockerd-rootless-setuptool.sh install
```

## Description

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

### Commit 1: `engine/security/rootless: split to multiple pages`
This commit only splits the page.
The content will be updated in subsequent commits.

### Commit 2: `engine/security/rootless: remove outdated/duplicated
info`

Setup:
- `dockerd-rootless-setuptool.sh` has been improved to show help when
the prerequisites are not satisfied.
Users no longer need to read the **lengthy** "prerequisites"
documentation unless they encounter issues.

- The document had duplicated descriptions about dbus, uidmap, and
machinectl stuffs in several places.

Graph drivers:
- Rootless OverlayFS has been merged into the upstream since kernel
5.11:
  torvalds/linux@459c7c565a .
  Ubuntu no longer patches the kernel.

- FUSE-OverlayFS is typically no longer needed on the current supported
distros,
  except EL 8.

SELinux:
- Remove a workaround for an issue that was already fixed in Docker
Engine v20.10.8.

CLI:
- `docker context use rootless` no longer needs to be executed manually,
  since Docker v23. (moby/moby#43061)

## Related issues or tickets

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

## Reviews

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

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


## Preview

https://deploy-preview-23302--docsdocker.netlify.app/engine/security/rootless/

---------

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
Co-authored-by: Paweł Gronowski <me@woland.xyz>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2025-09-08 10:19:18 +01:00