Skip to content

Add note for dual-stack listening on same port #771

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

Merged
alexandratran merged 4 commits into from
Jul 14, 2026
+15 −3
Merged

Add note for dual-stack listening on same port #771

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
48edbd4
Add note for dual-stack listening on same port
alexandratran Jul 10, 2026
7c89ffd
minor edit
alexandratran Jul 10, 2026
451dff5
fix trailing space
alexandratran Jul 10, 2026
4a1c0bb
Merge branch 'main' into 770-dual-stack-port-binding
alexandratran Jul 13, 2026
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
18 changes: 15 additions & 3 deletions docs/how-to/find-and-connect/configure-ipv6.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,21 +21,33 @@ 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.
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
Expand Down
Loading