From 43bb8e4f4c13261e35f6527b3887e4f3a622e3f8 Mon Sep 17 00:00:00 2001
From: Denozordec <shatskiy.blog@gmail.com>
Date: Mon, 9 Mar 2026 16:17:01 +0700
Subject: [PATCH] Update README.md to enhance local setup instructions and add
 Docker Registry usage examples

---
 README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 51 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index cfed3e9..beac7fa 100644
--- a/README.md
+++ b/README.md
@@ -19,15 +19,62 @@
 - `TELEGRAM_HTTP_TIMEOUT_SECONDS` - timeout запросов к Telegram (по умолчанию `60`).
 - `TELEMT_HTTP_TIMEOUT_SECONDS` - timeout запросов к Telemt API (по умолчанию `5`).
 
-## Быстрый старт (PowerShell)
+## Быстрый старт (локально, Linux/bash)
 
-```powershell
-Copy-Item .env.example .env
-# отредактируй .env
+```bash
+cp .env.example .env
+# отредактируй .env под свой Telemt и Telegram
 docker compose up --build -d
 docker compose logs -f
 ```
 
+## Запуск из Docker Registry
+
+### Через docker compose
+
+Пример `docker-compose.yml`, который использует уже собранный образ из Gitea Registry:
+
+```yaml
+services:
+  telemt-bot:
+    image: git.shts.su/denozord/telemt-bot:latest
+    restart: unless-stopped
+    environment:
+      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}
+      TELEGRAM_ADMIN_CHAT_ID: ${TELEGRAM_ADMIN_CHAT_ID}
+      TELEMT_API_BASE_URL: ${TELEMT_API_BASE_URL}
+      TELEMT_API_AUTH_HEADER: ${TELEMT_API_AUTH_HEADER}
+      TELEGRAM_HTTP_TIMEOUT_SECONDS: ${TELEGRAM_HTTP_TIMEOUT_SECONDS:-60}
+      TELEMT_HTTP_TIMEOUT_SECONDS: ${TELEMT_HTTP_TIMEOUT_SECONDS:-5}
+```
+
+Запуск (Linux/bash):
+
+```bash
+export TELEGRAM_BOT_TOKEN="xxx:telegram_bot_token"
+export TELEGRAM_ADMIN_CHAT_ID="123456789"
+export TELEMT_API_BASE_URL="http://host.docker.internal:9091"
+export TELEMT_API_AUTH_HEADER="Bearer secret"
+
+docker compose up -d
+docker compose logs -f
+```
+
+### Через docker CLI (Linux/bash)
+
+```bash
+docker run -d \
+  --name telemt-bot \
+  --restart unless-stopped \
+  -e TELEGRAM_BOT_TOKEN="xxx:telegram_bot_token" \
+  -e TELEGRAM_ADMIN_CHAT_ID="123456789" \
+  -e TELEMT_API_BASE_URL="http://host.docker.internal:9091" \
+  -e TELEMT_API_AUTH_HEADER="Bearer secret" \
+  -e TELEGRAM_HTTP_TIMEOUT_SECONDS="60" \
+  -e TELEMT_HTTP_TIMEOUT_SECONDS="5" \
+  git.shts.su/denozord/telemt-bot:latest
+```
+
 ## Почему решение экономное по ресурсам
 
 - Go-бинарник без рантайма и с нулевым CGO.