diff --git a/README.md b/README.md
index 497f6eb..f91de74 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,50 @@
 
 ## Установка
 
+### Вариант 1 — Docker (рекомендуется)
+
+**1. Клонируйте репозиторий**
+
+```bash
+git clone https://github.com/ваш-ник/auto-stars
+cd auto-stars
+```
+
+**2. Создайте `.env`** на основе примера и заполните его:
+
+```bash
+cp examples/.env.example .env
+```
+
+**3. Авторизуйтесь в Telegram**
+
+Pyrogram требует интерактивного входа при первом запуске. Выполните его локально:
+
+```bash
+pip install -r requirements.txt
+python main.py
+```
+
+Введите номер телефона и код подтверждения. После успешного входа бот создаст файл `storage/stars_bot.session` и завершится с сообщением о необходимости перезапуска. После этого Docker будет использовать готовую сессию.
+
+**4. Запустите через Docker Compose**
+
+```bash
+docker compose -f examples/docker-compose.yml up -d
+```
+
+Данные сессии и логи хранятся в `./storage` и `./logs` на хосте (или по путям `LOGS_PATH` / `STORAGE_PATH` из `.env`).
+
+**5. Просмотр логов**
+
+```bash
+docker compose -f examples/docker-compose.yml logs -f
+```
+
+---
+
+### Вариант 2 — Запуск напрямую
+
 **1. Клонируйте репозиторий**
 
 ```bash