diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..e97807f
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,23 @@
+# --- Telegram Bot Token ---
+# Get your bot token from @BotFather on Telegram
+TELEGRAM_TOKEN="your_telegram_bot_token_here"
+
+# --- Admin User IDs ---
+# Comma-separated list of Telegram user IDs who can run admin commands
+# To get your user ID, message @userinfobot on Telegram
+ADMIN_IDS="123456789,987654321"
+
+# --- PostgreSQL Database Connection ---
+# Choose a username, a SECURE password, and a database name.
+# The bot and the database container will use these values to connect.
+POSTGRES_HOST=echoes_of_the_ashes_db
+POSTGRES_PORT=5432
+POSTGRES_DB=echoes_of_the_ashes
+POSTGRES_USER=eota_user
+POSTGRES_PASSWORD=your_secure_database_password_here
+
+# --- Map Editor Configuration ---
+# Set a secure password for the web-based map editor
+EDITOR_PASSWORD="your_secure_editor_password_here"
+# Generate a random secret key for Flask sessions (use: python -c "import secrets; print(secrets.token_hex(32))")
+EDITOR_SECRET_KEY="your_secret_key_for_sessions_here_change_this"