Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Document how IPv6-only works in Docker Desktop #20918

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
+34 −0
Draft

Document how IPv6-only works in Docker Desktop #20918

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions content/manuals/desktop/networking.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -184,3 +184,35 @@

See the [run command](/reference/cli/docker/container/run.md) for more details on
publish options used with `docker run`.

### IPv4-only, Dual-stack and IPv6-only

{{% experimental title="Beta" %}}
This feature is currently in [Beta](../release-lifecycle.md#beta).

The exact semantics of all three options might change in future releases.

Note:

- IPv6 is not available for Docker Desktop on Linux.
- If using WSL 2 on Windows, the Linux kernel must have IPv6 configured and enabled.
{{% /experimental %}}
akerouanton marked this conversation as resolved.
Show resolved Hide resolved

Starting with v4.35, Docker Desktop has new options to configure how the VM behaves and the default
settings applied to Docker networks. Dual-stack is the default mode.

In IPv4-only mode, the DNS resolver embedded in the VM only serves A (= IPv4) records and
suppresses any AAAA (= IPv6) records. This might be useful if some of your containerized software

Check warning on line 205 in content/manuals/desktop/networking.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] ' AAAA' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] ' AAAA' has no definition.", "location": {"path": "content/manuals/desktop/networking.md", "range": {"start": {"line": 205, "column": 15}}}, "severity": "WARNING"}
tries to connect to IPv6 addresses but your host doesn't have proper IPv6 connectivity.

In Dual-stack mode, both A and AAAA records are served by the DNS resolver. Docker networks are

Check warning on line 208 in content/manuals/desktop/networking.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] ' AAAA' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] ' AAAA' has no definition.", "location": {"path": "content/manuals/desktop/networking.md", "range": {"start": {"line": 208, "column": 31}}}, "severity": "WARNING"}
created with an IPv4 subnet assigned, but no IPv6 subnet. You must pass the `--ipv6` flag to
[`docker network create`](https://docs.docker.com/reference/cli/docker/network/create/#options),
or put [`enable_ipv6: true`](https://docs.docker.com/reference/compose-file/networks/#enable_ipv6)
in network declarations in Compose files.

In IPv6-only mode, the DNS resolver serves only AAAA records, and Docker Engine assigns IPv6

Check warning on line 214 in content/manuals/desktop/networking.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] ' AAAA' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] ' AAAA' has no definition.", "location": {"path": "content/manuals/desktop/networking.md", "range": {"start": {"line": 214, "column": 48}}}, "severity": "WARNING"}
subnets by default to your networks. This might be useful if you run Docker Desktop in an
environment where IPv4 is getting phased out but has not been entirely shut down yet.

For more details about IPv6 in Docker Engine refer to [Use IPv6 networking](/manuals/engine/daemon/ipv6.md)
2 changes: 2 additions & 0 deletions data/redirects.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,8 @@
- /docker-hub/api/latest/
"/reference/api/hub/dvp/":
- /docker-hub/api/dvp/
"/desktop/networking/#ipv4-only-dual-stack-and-ipv6-only":
- /go/desktop-ipv6-only/

# feedback
"https://docs.google.com/forms/d/e/1FAIpQLSenjK8KiBiOrwCpq06u_iVEZGv4tfTEpfmY_cQDmsqJrHL9Gw/viewform":
Expand Down
Loading