diff --git a/.env.example b/.env.example
index eab23eb3..9db2ea25 100644
--- a/.env.example
+++ b/.env.example
@@ -79,6 +79,13 @@ FIELD_ENCRYPT_KEY=
 # Product-specific MEK name in AKV — only for 'akv' provider
 FIELD_ENCRYPT_MEK_NAME=lysnr-mek
 
+# ── Gitea NPM Registry (private @bytelyst packages) ─────────
+# Token for authenticating with the Gitea npm registry.
+# Generate at: http://<GITEA_NPM_HOST>:3300/user/settings/applications
+GITEA_NPM_TOKEN=
+GITEA_NPM_HOST=localhost
+GITEA_NPM_OWNER=learning_ai_user
+
 # ── Product Identity ──────────────────────────────────────────
 DEFAULT_PRODUCT_ID=lysnrai