From ffccc2c3b3993a899cdf1ec2e1e3dd6effe1eda8 Mon Sep 17 00:00:00 2001 From: milcastob <43559371+milcastob@users.noreply.github.com> Date: Sun, 28 Dec 2025 21:38:31 +0100 Subject: [PATCH] docs: add peering configuration guide Adds a document explaining how to configure peer connections, adjust peer limits, and handle NAT/firewall settings for Base nodes. --- docs/PEERING_GUIDE.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 docs/PEERING_GUIDE.md diff --git a/docs/PEERING_GUIDE.md b/docs/PEERING_GUIDE.md new file mode 100644 index 00000000..57b5aea5 --- /dev/null +++ b/docs/PEERING_GUIDE.md @@ -0,0 +1,20 @@ +# Peering configuration guide + +This guide provides tips on configuring peer connections for Base nodes. + +## Finding peers + +- Use `admin_peers` on the execution client to see current peers. +- Share your node's ENR with trusted peers to establish direct connections. + +## Adjusting peer limits + +- The `maxpeers` flag controls the maximum number of peers your node will accept. +- Lower values reduce bandwidth usage; higher values improve network robustness. + +## NAT and firewalls + +- Open TCP/UDP ports 30303–30305 on your router for inbound connections. +- Ensure your node advertises the correct public IP by setting `--nat extip:`. + +Keep this document updated as the network evolves.