diff --git a/.env.mainnet b/.env.mainnet
index c5bd040b..42a733de 100644
--- a/.env.mainnet
+++ b/.env.mainnet
@@ -46,6 +46,12 @@ BASE_NODE_L2_ENGINE_AUTH_RAW=688f5d737bad920bdfb2fc2f488d6b6209eebda1dae949a8de9
 
 # P2P CONFIGURATION
 # ---------------
+# HOST_IP (optional): Set this to your public-facing IPv4 address to improve peer discovery.
+# When set, the execution client advertises this address instead of the Docker internal IP.
+# Recommended for nodes behind NAT or in cloud environments (AWS, GCP, Hetzner, etc.).
+# Leave empty for automatic detection (works for most home/VPS setups).
+# Example: HOST_IP=1.2.3.4
+HOST_IP=
 OP_NODE_P2P_AGENT=base
 OP_NODE_P2P_LISTEN_IP=0.0.0.0
 OP_NODE_P2P_LISTEN_TCP_PORT=9222
diff --git a/.env.sepolia b/.env.sepolia
index cb9a8b54..d5e8ce3f 100644
--- a/.env.sepolia
+++ b/.env.sepolia
@@ -46,6 +46,12 @@ BASE_NODE_L2_ENGINE_AUTH_RAW=688f5d737bad920bdfb2fc2f488d6b6209eebda1dae949a8de9
 
 # P2P CONFIGURATION
 # ---------------
+# HOST_IP (optional): Set this to your public-facing IPv4 address to improve peer discovery.
+# When set, the execution client advertises this address instead of the Docker internal IP.
+# Recommended for nodes behind NAT or in cloud environments (AWS, GCP, Hetzner, etc.).
+# Leave empty for automatic detection (works for most home/VPS setups).
+# Example: HOST_IP=1.2.3.4
+HOST_IP=
 OP_NODE_P2P_AGENT=base
 OP_NODE_P2P_LISTEN_IP=0.0.0.0
 OP_NODE_P2P_LISTEN_TCP_PORT=9222