From e90748dbfd2bcc947a4da049572ec836a58a1a27 Mon Sep 17 00:00:00 2001
From: milcastob <43559371+milcastob@users.noreply.github.com>
Date: Sat, 27 Dec 2025 21:29:12 +0100
Subject: [PATCH] Create ENV_REFERENCE.md

Documents frequently used environment variables for Base node operators
---
 docs/ENV_REFERENCE.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 docs/ENV_REFERENCE.md

diff --git a/docs/ENV_REFERENCE.md b/docs/ENV_REFERENCE.md
new file mode 100644
index 00000000..406bada0
--- /dev/null
+++ b/docs/ENV_REFERENCE.md
@@ -0,0 +1,17 @@
+# Environment variable reference
+
+This document lists commonly used environment variables when running a Base node.
+
+## Core variables
+
+- `L1_RPC_URL` – Ethereum L1 RPC endpoint
+- `OP_NODE_RPC_URL` – OP node RPC endpoint
+- `JWT_SECRET` – JWT secret for engine API authentication
+
+## Optional tuning
+
+- `LOG_LEVEL` – logging verbosity (info, debug)
+- `RETH_DB_PATH` – custom path for reth database
+- `GOMAXPROCS` – CPU tuning for Go services
+
+Update this document when introducing new configuration options.