Skip to content

Commit 3643788

Browse files
dvdksnclaude
andcommitted
docs: warn that IPv6 examples use reserved addresses (fixes #13552)
The "Create an IPv6 network" and "Use IPv6 for the default bridge network" sections used RFC 3849 documentation-reserved addresses (2001:db8::/64) without warning, causing users to copy unusable config. Added notes matching the existing style in "Dynamic IPv6 subnet allocation", warning about the reserved range and suggesting ULA subnets from fd00::/8 as a replacement. Co-Authored-By: Claude <noreply@anthropic.com>
1 parent b49c6c7 commit 3643788

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

  • content/manuals/engine/daemon

content/manuals/engine/daemon/ipv6.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,13 @@ IPv6 is only supported on Docker daemons running on Linux hosts.
3535
- subnet: 2001:db8::/64
3636
```
3737
38+
> [!NOTE]
39+
>
40+
> The address `2001:db8::/64` in these examples is
41+
> [reserved for use in documentation][wikipedia-ipv6-reserved].
42+
> Replace it with a valid IPv6 network, for example a
43+
> [Unique Local Address (ULA)][wikipedia-ipv6-ula] subnet from `fd00::/8`.
44+
3845
You can now run containers that attach to the `ip6net` network.
3946

4047
```console
@@ -74,6 +81,13 @@ The following steps show you how to use IPv6 on the default bridge network.
7481
}
7582
```
7683

84+
> [!NOTE]
85+
>
86+
> The address `2001:db8:1::/64` in this example is
87+
> [reserved for use in documentation][wikipedia-ipv6-reserved].
88+
> Replace it with a valid IPv6 network, for example a
89+
> [Unique Local Address (ULA)][wikipedia-ipv6-ula] subnet from `fd00::/8`.
90+
7791
- `ipv6` enables IPv6 networking on the default network.
7892
- `fixed-cidr-v6` assigns a subnet to the default bridge network,
7993
enabling dynamic IPv6 address allocation.

0 commit comments

Comments
 (0)