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

423 Commits

Author SHA1 Message Date
Sebastiaan van Stijn
4bc08433fe Merge pull request #25967 from vvoland/update-docker
engine: 29.8.0
2026-09-04 00:32:54 +02:00
Paweł Gronowski
a40be26313 Merge pull request #25993 from vvoland/rootless-pesto
engine/rootless: Document pesto port driver
2026-09-03 23:31:10 +02:00
Paweł Gronowski
012c47d5ab Merge pull request #25607 from vvoland/apparmor-custom-profiles
engine/security: Document custom AppArmor profile templates
2026-09-03 23:30:55 +02:00
Paweł Gronowski
154258dce8 engine: 29.8.0
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-09-03 23:22:11 +02:00
Paweł Gronowski
28fed227a7 engine: 29.8.0-rc.1
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-09-03 22:10:57 +02:00
Paweł Gronowski
a3888970d5 engine/security: Document custom AppArmor profile templates
Docker Engine 29.8 can render docker-default from a daemon-configured Go
template.

Document the supported template data, safe file placement, daemon
configuration, and verification so administrators do not treat the
template as a directly loadable profile.

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-09-03 14:54:15 +02:00
Sebastiaan van Stijn
88c23a1ca4 Merge pull request #25658 from vvoland/containerd-embedded
engine/daemon: Document embedded containerd mode
2026-09-03 14:46:34 +02:00
Paweł Gronowski
1865440c39 engine/daemon: Document embedded containerd mode
Explain how Engine 29.7.0 can run containerd inside dockerd, how to
enable and verify the experimental mode, and how external clients can
connect to its endpoint.

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-09-03 14:38:19 +02:00
Paweł Gronowski
5d22477d13 engine/network: Update legacy-link deprecation
Keep the legacy-link reference while warning that default-bridge links
and legacy-link environment variables are scheduled for removal in
Docker Engine 30.0.
Document the environment variable escape hatch.

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-09-01 17:12:02 +02:00
Paweł Gronowski
0571430b6a engine/rootless: Document pesto port driver
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-09-01 17:02:17 +02:00
Christian Decker
359f92fdf9 Make a python3 example and not a python3 example. 2026-08-31 10:09:46 +02:00
Usha Mandya
cb6f394c0f Remove the outdated docker workshop section
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2026-08-28 12:13:05 +01:00
Daniel
efa340b605 docs: Add external property back to compose and add swarm secrets example using compose (#25522)
<!--Delete sections as needed -->

## Description

Added back the attribute `external` in the `/reference/compose/secrets`
section with a warning that this attribute is only available for Docker
Swarm. Additionally, I added a small toy reference example to the
section "Defining and using Secrets in compose files" and moved the
section outside of the "Examples" section. The reason why I did this is
because I noticed the Examples are all runnable steps that showcase
concrete usage of secrets, the example I added is just a
skeleton/reference to how they should be used in conjunction with
`docker secret create...`, not a true able-to-run example like the ones
below. I also changed the hyperlink from
`/reference/compose-file/legacy-versions.md` to
`/reference/compose-file/secrets.md`.

A few caveats that I wasn't sure about when writing this:
- I'm not sure if using the "[!NOTE]" in the attributes list is the
approach maintainers and writers might favor and I can change it
accordingly
- I'd love to hear feedback on moving "Defining and using secrets in
compose files" outside of "Examples" due to my reasoning above

Edit:
I'm also not opposed to making a fully working example using compose,
stack and secrets and putting the section back under `Examples`

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

## Related issues or tickets
 #25491 
<!-- 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: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2026-08-27 08:51:49 +01:00
mickael emirkanian
ec99ba450b docs(engine) clarify seccomp default profile 2026-08-21 14:21:38 -04:00
Dean Chen
005d3bc7c3 docs: note that tmpfs usage counts toward container memory limit (#25741)
tmpfs is backed by host memory and that usage is charged to the
container's memory cgroup. A large `tmpfs-size` (or a host-mounted
tmpfs) does not give you RAM outside `--memory`, and filling the mount
can still OOM the container.

Called that out in the intro and limitations, with a pointer to the
runtime metrics page.

Fixes moby/moby#47967

---------

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-18 09:42:24 +02:00
Dean Chen
ae79444a45 Merge pull request #25750 from locker95/docs/max-size-unit-case
docs: note max-size unit modifiers are case-insensitive
2026-08-18 09:13:14 +02:00
David Karlsson
6362cc9623 Merge pull request #25829 from locker95/docs/rootless-delegate-selectable
docs: make rootless cgroup delegate.conf copy-pasteable
2026-08-18 09:08:30 +02:00
David Karlsson
42df77e02f Merge pull request #25853 from locker95/docs/links-port-mapping-pointer
docs: say -p on the links page is not --link
2026-08-17 15:31:22 +02:00
David Karlsson
28456a5d01 Merge pull request #25854 from locker95/docs/unless-stopped-restart
docs: say unless-stopped still restarts after a daemon reboot
2026-08-17 15:30:47 +02:00
David Karlsson
b1887cc914 Merge pull request #25859 from locker95/docs/overlay-data-path-port
docs: use --data-path-port for the overlay VXLAN port
2026-08-17 15:29:53 +02:00
David Karlsson
2dbc898a01 Merge pull request #25860 from locker95/docs/host-has-swap
docs: say the host, not the host container, has swap
2026-08-17 15:29:17 +02:00
David Karlsson
899f216c4e Merge pull request #25861 from locker95/docs/host-net-publish-link
docs: point host-network port mapping at the publish page
2026-08-17 15:28:57 +02:00
David Karlsson
a51476edbb Merge pull request #25862 from locker95/docs/swarm-tutorial-ip-addr
docs: prefer ip addr over ifconfig in the swarm tutorial
2026-08-17 15:28:24 +02:00
David Karlsson
a30229efdd Merge pull request #25742 from locker95/locker95-system-prune-build-cache-manual
docs: mention build cache in system prune overview
2026-08-17 15:27:39 +02:00
Dean Chen
e4657b8a17 docs: prefer ip addr over ifconfig in the swarm tutorial
ifconfig is often missing on current Linux images. Keep ifconfig for macOS.

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 21:40:07 +05:00
Dean Chen
3f79c9b905 docs: say publish options, not option, on the host-network note
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 21:39:52 +05:00
Dean Chen
c44db82915 docs: say the host, not the host container, has swap
Memory-swap fallback is about the Docker host's swap, not a container.

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 19:39:24 +05:00
Dean Chen
58582ce4cd docs: point host-network port mapping at the publish page
overlay.md has no #publish-ports heading. Host mode ignores -p, so
link the published-ports page instead.

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 19:39:24 +05:00
Dean Chen
dc98e192e7 docs: drop extra 'to' in the live-restore sentence
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 17:39:15 +05:00
Dean Chen
b23b6c519e docs: use --data-path-port for the overlay VXLAN port
The table linked the data-path-port docs but named --data-path-addr,
which is the address, not 4789/udp.

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 17:39:15 +05:00
Dean Chen
af4facde47 docs: drop doubled 'logging driver' in the json-file tip
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 15:38:19 +05:00
Dean Chen
2f9456525b docs: say unless-stopped still restarts after a daemon reboot
The example used --restart unless-stopped, but the sentence next to it
read like the container would stay down when dockerd came back.

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 13:47:16 +05:00
Dean Chen
2d9d632666 docs: say -p on the links page is not --link
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-16 11:38:27 +05:00
Dean Chen
a20e3585fe docs: make rootless cgroup delegate.conf copy-pasteable
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-14 08:37:27 +05:00
Dean Chen
be8eb17924 docs: point Notary production section at upstream deploy docs
The steps above already link the Notary service guide. The production
section still said to wait for an official stable release.

Fixes #25145

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-14 00:52:09 +05:00
Dean Chen
24c67bab57 docs: mention build cache in system prune overview
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-13 21:05:50 +05:00
Santhi Prakash
a1ed7bd395 docs: system prune default keeps unused tagged images
- Problem: the prune-everything section said the default removes all unused images. Live docker system prune only removes dangling images unless -a is passed.
- Fix: say unused containers/networks plus dangling images by default, and that unused tagged images need -a/--all.
- Verification: docker 29.1.3 — default warning lists "all dangling images"; docker system prune -a lists "all images without at least one container associated to them". Closed #17488 wanted to change the example to include -a and went stale; this only corrects the default-behavior sentence.
2026-08-13 14:46:03 +00:00
Santhi Prakash
a127c372c2 docs: system prune --volumes removes anonymous volumes only
- Problem: the pruning guide said docker system prune --volumes removes all unused volumes, and the example warning still said "all volumes" / "all build cache".
- Fix: match Docker 29.1.3 CLI help and confirmation text: --volumes prunes unused anonymous volumes; named volumes need docker volume prune --all.
- Verification: compared live `docker system prune --help` and the `docker system prune --volumes` warning (answered n) on 29.1.3.
2026-08-13 12:54:45 +00:00
Dean Chen
c8c1ada37a docs: note unpublished-port filter vs pre-netfilter DNAT (#25760)
When something else (e.g. a CNI) rewrites packets to a container IP
before host netfilter, Docker's unpublished-port protection still
applies. `DOCKER-USER` never sees that as "published" traffic.

Added a short note under the iptables DOCKER-USER section pointing at
port publishing / `nat-unprotected`.

Fixes #25676

---------

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-12 20:53:54 +02:00
Dean Chen
159e6c81fc docs: volume prune default is anonymous only
The pruning guide said all unused volumes are removed by default.
CLI actually keeps unused named volumes unless --all is set.

Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-12 18:02:37 +05:00
David Karlsson
2712b53a37 Merge pull request #25771 from locker95/docs/windows-registry-certs
docs: note Windows path for registry client certificates
2026-08-11 11:36:56 +02:00
David Karlsson
4eaf47e316 Merge pull request #25770 from locker95/docs/bind-mount-autocreate-perms
docs: note permission failures when auto-creating bind mount sources
2026-08-11 11:33:08 +02:00
Dean Chen
ea0ddf313c docs: document platform paths for registry client certificates
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-11 13:56:10 +05:00
Dean Chen
7a8a1eb5d6 docs: note permission failures when auto-creating bind mount sources
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-11 13:56:10 +05:00
Dean Chen
adac102be2 docs(rootless): note user-namespace scope of --cap-add capabilities
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-11 13:56:10 +05:00
David Karlsson
3eae0e4117 Merge pull request #25766 from locker95/docs/trust-sandbox-version-prereqs
docs: drop ancient Engine/Compose version pins in trust sandbox
2026-08-11 08:59:31 +02:00
Dean Chen
2e21b58c0e docs: drop ancient Engine/Compose version pins in trust sandbox
Signed-off-by: Dean Chen <862469039@qq.com>
2026-08-11 07:45:31 +05:00
Paweł Gronowski
dd2797b842 Drop Ubuntu 25.10
It's EOL

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-08-10 18:29:32 +02:00
David Karlsson
8b321e7935 Merge pull request #25689 from codewithdaniel1/docs-remove-linked-containers-restart-policy-25684
docs: remove linked containers restart policy note
2026-08-10 16:02:25 +02:00
Paweł Gronowski
5930d840f9 engine: 29.7.2
Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>
2026-08-05 20:26:07 +02:00