From ae59c867e1dee0a3e81d38fd054cb67dffec638d Mon Sep 17 00:00:00 2001
From: TheMagamed78 <composewgf@gmail.com>
Date: Tue, 3 Feb 2026 17:02:51 +0100
Subject: [PATCH] docs: add network ports reference table

Add a clear table of network ports used by the node components to help users configure firewalls and network access correctly.
---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 1cbaad17d..df62dbaa4 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,18 @@ Base is a secure, low-cost, developer-friendly Ethereum L2 built on Optimism's [
    NETWORK_ENV=.env.sepolia CLIENT=reth docker compose up --build
    ```
 
+### Network Ports Reference
+
+If you are running the node behind a firewall, ensure the following ports are open:
+
+| Port | Protocol | Description |
+|------|----------|-------------|
+| 8545 | TCP      | Execution Client RPC |
+| 8546 | TCP      | Execution Client WebSocket |
+| 30303| TCP/UDP  | Execution Client P2P |
+| 9003 | TCP/UDP  | Consensus Client P2P |
+| 7300 | TCP      | Metrics (Prometheus) |  
+
 ### Supported Clients
 
 - `reth` (default)