diff --git a/docs/how-to/find-and-connect/configure-ipv6.md b/docs/how-to/find-and-connect/configure-ipv6.md index 9175a17bb..a86c38f9e 100644 --- a/docs/how-to/find-and-connect/configure-ipv6.md +++ b/docs/how-to/find-and-connect/configure-ipv6.md @@ -21,9 +21,11 @@ In single-stack mode, Teku uses port `9000` for TCP and UDP, and `9001` for QUIC ## Listen over both IPv4 and IPv6 (dual-stack) -To configure Teku to listen over both IPv4 and IPv6, also known as dual-stack support, set the +To configure Teku to listen over both IPv4 and IPv6 (dual-stack), set the [`--p2p-interface`](../../reference/cli/index.md#p2p-interface-p2p-interfaces) CLI option to -`0.0.0.0,::` for both IPv4 and IPv6 listening addresses. +one IPv4 address and one IPv6 address, separated by a comma. +For example, set it to `0.0.0.0,::` to listen on all IPv4 and IPv6 interfaces. + In this setup, the [`--p2p-port`](../../reference/cli/index.md#p2p-port), [`--p2p-udp-port`](../../reference/cli/index.md#p2p-udp-port), and [`--p2p-quic-port`](../../reference/cli/index.md#p2p-quic-port) options apply to the IPv4 address. @@ -31,11 +33,21 @@ The [`--p2p-port-ipv6`](../../reference/cli/index.md#p2p-port-ipv6), [`--p2p-udp-port-ipv6`](../../reference/cli/index.md#p2p-udp-port-ipv6), and [`--p2p-quic-port-ipv6`](../../reference/cli/index.md#p2p-quic-port-ipv6) options apply to the IPv6 address. -After dual-stack support is enabled, Teku uses the following ports by default: +In dual-stack mode, Teku uses the following ports by default: - On IPv4: `9000` for TCP and UDP, and `9001` for QUIC (UDP) - On IPv6: `9090` for TCP and UDP, and `9091` for QUIC (UDP) +:::note Listen on the same port + +In dual-stack mode, you can set an IPv6 listening port to the same value as its corresponding IPv4 port. +If the ports match and [`--p2p-interface`](../../reference/cli/index.md#p2p-interface-p2p-interfaces) +includes the IPv6 wildcard address (`::`), Teku binds a single IPv6 wildcard listener for that +port, accepting both IPv4 and IPv6 connections on all interfaces. +This applies independently to the TCP, UDP discovery, and QUIC ports. + +::: + ## Advertise only the IPv6 address To advertise only the IPv6 public address to the network, use the