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

48 Commits

Author SHA1 Message Date
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
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
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
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
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
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
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
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
David Karlsson
3eade388e3 Document DSR overlay networks (#25613)
## Summary

Document the DSR option for Linux east-west overlay traffic and restore
the legacy overlay tutorial redirect.

Closes #9652

Generated by Codex

Co-authored-by: Codex <noreply@openai.com>
2026-07-23 12:15:36 +02:00
David Karlsson
b792e25b94 docs: clarify multiple DNS server behavior (fixes #7981)
Resolver libraries can query multiple DNS servers differently, making results depend on the container network and runtime. Add a note distinguishing application-controlled lookups on the default bridge from Docker's ordered upstream lookups on custom networks.

Co-Authored-By: Codex <noreply@openai.com>
2026-07-21 10:36:25 +00:00
David Karlsson
5a90cf9fd0 docs: document DSR overlay networks (fixes #9652)
The overlay networking docs omitted the supported DSR driver option. Document Linux east-west DSR usage and restore the legacy tutorial redirect.

Co-Authored-By: Codex <noreply@openai.com>
2026-07-21 10:12:22 +00:00
David Karlsson
d751b36e43 Merge pull request #23977 from Teeed/main
Fixed doc links regarding options (host_ip, gateway_mode) in bridge driver
2026-07-14 08:19:06 +02:00
Rob Murray
7ce3fd0512 docs: document router-assigned (SLAAC) IPv6 on macvlan/ipvlan
Add a "Use router-assigned IPv6 addresses" subsection to the macvlan and
ipvlan driver pages explaining how to receive IPv6 addresses via SLAAC
instead of Docker IPAM. Setting the per-interface net.ipv6.conf.IFNAME.disable_ipv6
sysctl to 0 via the endpoint.sysctls driver option re-enables IPv6 on the
interface so it can accept router advertisements, and the section links to
the docker network connect sysctl reference for the full mechanism.

Also add ipv6 and slaac keywords to both pages to improve discoverability.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 14:17:11 +01:00
Louis-Arnaud Catoire
89c3fb335d Remove duplicate overlay network port requirements
The port requirements were listed twice: as a bullet list under
Requirements and as a more detailed table under Create an overlay
network. Keep the detailed table under Requirements, where the port
requirements belong, and drop the redundant copy.

Fixes #25073
2026-05-21 16:55:09 +02:00
Codex
b7883153ea docs: replace "re-use" with "reuse" in links guide 2026-04-20 10:53:05 +08:00
David Karlsson
b04fc5429b Fix missing --ipv6 flag in IPVLAN L3 dual-stack example
The L3 dual-stack IPVLAN example omitted the --ipv6 flag when creating
the network, causing Docker to default to EnableIPv6: false despite an
IPv6 subnet being specified. The L2 example already includes this flag.

Fixes #19337

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-14 11:16:08 +02:00
dvdksn
a8c5858972 docs: document 127.0.0.11 embedded DNS server address
Add a brief mention of the embedded DNS server IP address (127.0.0.11)
to the DNS services section of the networking overview. Notes that
there is no IPv6 equivalent and that applications like Nginx can use
this address for explicit DNS configuration.

Fixes #20532

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-17 14:36:10 +01:00
David Karlsson
c5b3cb60ad chore: fix links pointing to redirect targets
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-24 08:01:08 +01:00
David Karlsson
70d0c07c69 site: use content adapters for cli reference
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-24 08:01:05 +01:00
Tadeusz Magura-Witkowski
97e3b4aad4 Fixed doc links regarding options (host_ip, gateway_mode) in drivers/bridge 2026-01-14 18:55:50 +01:00
hashlash
6bc51ebe72 Fix typo in Docker IP forwarding documentation
Corrected a typo in the Docker section regarding IP forwarding settings.
2025-12-26 09:18:06 +07:00
David Karlsson
0ff924b333 engine: consolidate network drivers documentation
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-21 19:51:11 +01:00
David Karlsson
5c1413d481 Merge pull request #23603 from robmry/subnet-by-prefixlen
Describe default-address-pools, and --subnet prefix-len option
2025-11-13 11:54:41 +01:00
Rob Murray
525496dd4a Engine: fix mention of ipvlan-l2 in macvlan doc
Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-11-13 10:15:11 +00:00
Rob Murray
c8bb66be1b Engine: note that macvlan containers can't reach the host
Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-11-13 10:15:11 +00:00
Rob Murray
4526e06a6a Engine: document com.docker.network.host_ipv4 / host_ipv6
Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-11-13 10:15:11 +00:00
David Karlsson
9fe8e768d1 lint: add MD059/descriptive-link-text markdownlint rule
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-11-03 15:24:10 +01:00
Rob Murray
a8d2c50697 Describe default-address-pools, and --subnet prefix-len option
Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-10-29 11:17:51 +00:00
Sebastiaan van Stijn
b6d6f364e9 networking documentation changes for engine v29 (#23362)
<!--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: Rob Murray <rob.murray@docker.com>
Co-authored-by: Rob Murray <rob.murray@docker.com>
Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
2025-10-16 15:39:22 +01:00
Arthur
26d2041243 chore(vale): build fixes (#23277) 2025-08-20 11:23:38 +02:00
Rob Murray
62d250966b New engine options, "allow-direct-routing" and "trusted_host_interfaces" (#22601)
## Description

~**This update is for moby 28.2.0 - do not merge until it ships.**~ -
28.2 has shipped now.

Add description for daemon option `--allow-direct-routing` and network
option `com.docker.network.bridge.trusted_host_interfaces`.

## Related issues or tickets

https://github.com/moby/moby/pull/49832

## Reviews

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

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

Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-06-03 10:35:15 +02:00
Rob Murray
942475214b Update text about direct routing
Since 28.0.0, direct access to container ports from outside
the host has been blocked.

Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-05-07 15:04:03 +01:00
Rob Murray
8d9f59ce1d Update warning about ports published to 127.0.0.1
Fixed in 28.0.0 - aligning with packet-filtering-firewalls.md.

Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-05-07 15:04:03 +01:00
fliespl
043dabd135 add another iptables rule to allow dns queries from container
Co-authored-by: Rob Murray <rob.murray@docker.com>
Co-authored-by: fliespl <a.rzadkowolski@gmail.com>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2025-05-06 12:31:01 +02:00
aevesdocker
458ca8b842 network link 2025-04-15 13:27:23 +01:00
Rob Murray
2090e5bcbb Updates for moby 28.0.1 (#22086)
## Description

- Describe new iptables chain `DOCKER-FORWARD`, which splits Docker's
rules out of the main `FORWARD` chain where they were being antisocial -
related to https://github.com/moby/moby/pull/49518
- Update notes about IP Forwarding and the default DROP policy
- Only engine < 28.0.0 allows remote access to ports published to the
localhost address

## Related issues or tickets

## Reviews

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

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

---------

Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-02-26 14:10:18 +00:00
Rob Murray
3520fa2ed9 Updates for moby 28.0 networking (#21612)
## Description

Updates for moby 28.0 networking.

## Related issues or tickets

Series of commits ...
- Fix description of 'inhibit_ipv4'
- Not changed in moby 28.0, updated to clarify difference from (new)
IPv6-only networks.
- Updates to default bridge address config
  - https://github.com/moby/moby/pull/48319
- Describe IPv6-only network config
  - https://github.com/moby/moby/pull/48271
  - https://github.com/docker/cli/pull/5599
- Update description of gateway modes
  - https://github.com/moby/moby/pull/48594
  - https://github.com/moby/moby/pull/48596
  - https://github.com/moby/moby/pull/48597
- Describe gateway selection in the networking overview.
  - https://github.com/docker/cli/pull/5664
- Describe gateway mode `isolated`
  - https://github.com/moby/moby/pull/49262

## Reviews

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

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

---------

Signed-off-by: Rob Murray <rob.murray@docker.com>
2025-02-20 10:09:14 +00:00
Petteri Räty
65585fdd6c Fix argument name to docker network create (#21966)
<!--Delete sections as needed -->

## Description

```
$ docker network create --help | grep opt
      --ipam-opt map         Set IPAM driver specific options (default map[])
  -o, --opt map              Set driver specific options (default map[])
```

So the documentation should be changed from using --option to --opt.
2025-02-05 11:01:18 +00:00
Craig Osterhout
7008f1f213 add aliases for 404s (#21945)
<!--Delete sections as needed -->

## Description

Add some aliases for some top 404s.

https://heapanalytics.com/app/env/4204607514/graph/chart/Docs-Weekly-404-Errors-13539083

## 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-01-31 14:10:10 -08:00
David Karlsson
2a11e52300 Merge pull request #21753 from dvdksn/dd-host-nw-ga
networking: host driver in dd is no longer beta
2025-01-11 08:54:32 +01:00
David Karlsson
2530d03f9a networking: host driver in dd is no longer beta
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-01-09 14:07:44 +01:00
David Karlsson
08bbe48015 chore: remove stray mentions of Docker EE
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-01-09 14:04:26 +01:00
Sarah Sanders
be328b9958 Update all outdated callouts 2024-11-08 10:31:58 -08:00
Jorge Paravicini
5b8eaf633f docs: update settings path 2024-10-11 12:34:48 +02:00
David Karlsson
435b80df3d engine: add instructions for using ca certs with docker
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-25 08:41:35 +02:00
David Karlsson
f634b5eb4d fix: correct link to networking engine plugins
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-09 14:21:36 +02:00
David Karlsson
656d1a871c chore: add navigation stubs, weights
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-09 11:24:49 +02:00
David Karlsson
135870fc13 hugo: move manuals content to /manuals section
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-09-09 10:51:09 +02:00