diff --git a/core/.env.example b/core/.env.example
new file mode 100644
index 0000000..d3e7236
--- /dev/null
+++ b/core/.env.example
@@ -0,0 +1,14 @@
+# .env.example – скопируйте в .env и заполните реальными значениями
+
+# Пароль для XMPP подключения бота (используется в profile.yaml: password_env)
+XMPP_PASSWORD=your_strong_password_here
+
+# Пароль для MariaDB (пользователь bot_manager)
+DB_PASSWORD=your_db_password_here
+
+# API ключ GigaChat (получить в личном кабинете Сбера)
+GIGACHAT_API_KEY=your_gigachat_api_key_here
+
+# Авторизация для SaluteSpeech (голосовые сообщения)
+# Формат: base64 от "ключ:секрет"
+SALUTE_SPEECH_AUTH=base64_auth_string_here
\ No newline at end of file