diff --git a/docs/base-chain/node-operators/run-a-base-node.mdx b/docs/base-chain/node-operators/run-a-base-node.mdx index 2196e3280..8cb92e696 100644 --- a/docs/base-chain/node-operators/run-a-base-node.mdx +++ b/docs/base-chain/node-operators/run-a-base-node.mdx @@ -43,6 +43,19 @@ If utilizing Amazon Elastic Block Store (EBS), ensure timing buffered disk reads +### Networking + +Ensure the following ports are accessible (not blocked by firewall) for peer discovery and sync: + +| Port | Protocol | Purpose | +|------|----------|---------| +| `30303` | TCP/UDP | P2P Discovery (discv4) & RLPx | +| `9222` | TCP/UDP | Reth Discovery v5 (discv5) | + + +Port `9222` is critical for Reth peer discovery. If this port is blocked, your node may have difficulty finding peers and syncing. + + ### Docker This tutorial assumes you are familiar with [Docker](https://www.docker.com/) and have it running on your machine. diff --git a/docs/base-chain/node-operators/troubleshooting.mdx b/docs/base-chain/node-operators/troubleshooting.mdx index e6cda1e43..9ff8125c8 100644 --- a/docs/base-chain/node-operators/troubleshooting.mdx +++ b/docs/base-chain/node-operators/troubleshooting.mdx @@ -107,7 +107,7 @@ Refer to the [Snapshots](/base-chain/node-operators/snapshots) guide for the cor - **Check**: Are the `--http.addr` and `--ws.addr` flags set to `0.0.0.0` in the client config/entrypoint to allow external connections (within the Docker network)? - **Issue**: Node has low peer count. - - **Check**: P2P port (default `30303`) accessibility. Is it blocked by a firewall on the host or network? + - **Check**: P2P port accessibility. Ensure `30303` (TCP/UDP) and `9222` (TCP/UDP for Reth discv5) are not blocked by a firewall on the host or network. - **Check**: Node logs for P2P errors. - **Action**: If behind NAT, configure the `--nat=extip:` flag via `ADDITIONAL_ARGS` in the `.env` file (see [Advanced Configuration](/base-chain/node-operators/run-a-base-node#improving-peer-connectivity)).