From c585785ce7501b8e508d487f39aad31225ad1284 Mon Sep 17 00:00:00 2001
From: kewe63 <kewe.3217@gmail.com>
Date: Mon, 11 May 2026 13:43:39 +0300
Subject: [PATCH] docs: document HOST_IP and HOST_DATA_DIR in env files

---
 .env                 |  8 ++++++++
 .env.mainnet         |  9 +++++++++
 .env.sepolia         | 13 +++++++++++--
 geth/geth-entrypoint |  2 +-
 4 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/.env b/.env
index f4ea7b66a..592a5b707 100644
--- a/.env
+++ b/.env
@@ -1,3 +1,11 @@
 CLIENT=${CLIENT:-reth}
 HOST_DATA_DIR=./${CLIENT}-data
 USE_BASE_CONSENSUS=true
+
+# OPTIONAL NETWORKING SETTINGS
+# Advertises your public IP to P2P peers for better discovery.
+# HOST_IP=<your-public-ip>
+
+# OPTIONAL STORAGE SETTINGS
+# Override the host directory where chain data is stored.
+# HOST_DATA_DIR=/path/to/chain-data
diff --git a/.env.mainnet b/.env.mainnet
index c5bd040b5..35ff1a815 100644
--- a/.env.mainnet
+++ b/.env.mainnet
@@ -97,6 +97,15 @@ STATSD_ADDRESS="172.17.0.1"
 # OPTIONAL SETTINGS
 # ===============
 
+# HOST NETWORKING (OPTIONAL - SET IF BEHIND NAT)
+# Advertises your public IP to P2P peers for better peer discovery.
+# HOST_IP=<your-public-ip>
+
+# DATA DIRECTORY (OPTIONAL - OVERRIDE DEFAULT)
+# Override the host directory where chain data is stored.
+# Defaults to ./<CLIENT>-data if not set.
+# HOST_DATA_DIR=/path/to/chain-data
+
 # ETHSTATS MONITORING (OPTIONAL - UNCOMMENT TO ENABLE)
 # OP_GETH_ETH_STATS=nodename:secret@host:port
 # OP_NETHERMIND_ETHSTATS_ENABLED=true
diff --git a/.env.sepolia b/.env.sepolia
index cb9a8b545..fcfd7c400 100644
--- a/.env.sepolia
+++ b/.env.sepolia
@@ -38,9 +38,9 @@ BASE_NODE_L1_TRUST_RPC="false"
 # ENGINE CONFIGURATION
 # -------------------
 OP_NODE_L2_ENGINE_KIND=reth
-OP_NODE_L2_ENGINE_RPC=ws://execution:8551
+OP_NODE_L2_ENGINE_RPC=http://execution:8551
 
-BASE_NODE_L2_ENGINE_RPC=http://execution:8551
+BASE_NODE_L2_ENGINE_RPC=ws://execution:8551
 BASE_NODE_L2_ENGINE_AUTH=/tmp/engine-auth-jwt
 BASE_NODE_L2_ENGINE_AUTH_RAW=688f5d737bad920bdfb2fc2f488d6b6209eebda1dae949a8de91398d932c517a
 
@@ -97,6 +97,15 @@ STATSD_ADDRESS="172.17.0.1"
 # OPTIONAL SETTINGS
 # ===============
 
+# HOST NETWORKING (OPTIONAL - SET IF BEHIND NAT)
+# Advertises your public IP to P2P peers for better peer discovery.
+# HOST_IP=<your-public-ip>
+
+# DATA DIRECTORY (OPTIONAL - OVERRIDE DEFAULT)
+# Override the host directory where chain data is stored.
+# Defaults to ./<CLIENT>-data if not set.
+# HOST_DATA_DIR=/path/to/chain-data
+
 # ETHSTATS MONITORING (OPTIONAL - UNCOMMENT TO ENABLE)
 # OP_GETH_ETH_STATS=nodename:secret@host:port
 # OP_NETHERMIND_ETHSTATS_ENABLED=true
diff --git a/geth/geth-entrypoint b/geth/geth-entrypoint
index b598cb3f4..3aba51081 100755
--- a/geth/geth-entrypoint
+++ b/geth/geth-entrypoint
@@ -7,7 +7,7 @@ RPC_PORT="${RPC_PORT:-8545}"
 WS_PORT="${WS_PORT:-8546}"
 AUTHRPC_PORT="${AUTHRPC_PORT:-8551}"
 METRICS_PORT="${METRICS_PORT:-6060}"
-HOST_IP="" # put your external IP address here and open port 30303 to improve peer connectivity
+HOST_IP="${HOST_IP:-}" # put your external IP address here and open port 30303 to improve peer connectivity
 P2P_PORT="${P2P_PORT:-30303}"
 DISCOVERY_PORT="${DISCOVERY_PORT:-30303}"
 ADDITIONAL_ARGS=""