From 65e355ef66b9cb4677e53ea7cc47998224b11a17 Mon Sep 17 00:00:00 2001
From: hoelee <me@hoelee.com>
Date: Fri, 7 Aug 2026 13:41:58 +0800
Subject: [PATCH] docs: add first-time login instructions for Docker deployment

---
 README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/README.md b/README.md
index b2bb605..45980de 100644
--- a/README.md
+++ b/README.md
@@ -46,6 +46,24 @@ docker compose up -d
 docker compose logs -f telegram-backup
 ```
 
+> **First-time login:** if `telegram_session.session` doesn't exist yet, the container needs your Telegram verification code. Run interactively first:
+>
+> ```bash
+> # Stop the detached container if running
+> docker compose down
+>
+> # Run interactively — you'll be prompted for phone + verification code
+> docker compose up
+>
+> # After successful login, press Ctrl+C to stop
+> docker compose down
+>
+> # Now start detached — session is saved
+> docker compose up -d
+> ```
+>
+> The session file is written to `./telegram_session.session` on the host, so subsequent starts won't ask for verification again (unless it expires or you delete the file).
+
 This is the `docker-compose.yml`:
 
 ```yaml