diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..c8205ae
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,9 @@
+# Только для dev-remote (docker-compose.dev-remote.yml) — скопировать в .env
+# прямо на dev VPS (в директорию, где лежит compose-файл). Прод
+# (docker-compose.yml) секретов не требует — все URL/домены захардкожены
+# прямо в нём (там нет ни одного пароля/токена, только публичные адреса).
+#
+# ОБЯЗАТЕЛЬНО: отдельный dev-бот, заведённый через @BotFather специально под
+# домен dev.netrunner-vpn.com — НЕ прод-бот (у него уже прописан прод-домен
+# через /setdomain, молчаливый фолбэк на него ловится как "Bot domain invalid").
+BOT_USERNAME=CHANGE_ME_DEV_BOT_USERNAME
diff --git a/.gitignore b/.gitignore
index a7a6a6c..d440666 100644
--- a/.gitignore
+++ b/.gitignore
@@ -32,6 +32,7 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # vercel
 .vercel