From e4fc6acf9b9da0a12fbdf1059e7e7ec9d3f68141 Mon Sep 17 00:00:00 2001
From: host <arumyantsev@rummail.ru>
Date: Sat, 4 Apr 2026 16:57:03 +0300
Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D0=B3=D1=80=D1=83=D0=B7=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20=D1=84=D0=B0=D0=B9=D0=BB=D1=8B=20=D0=B2=20=C2=AB?=
 =?UTF-8?q?/=C2=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 137 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 137 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..35e1a54
--- /dev/null
+++ b/README.md
@@ -0,0 +1,137 @@
+# TorrentStack
+
+Простой и воспроизводимый стек для работы с торрентами и управления загрузками.
+
+Включает в себя:
+
+- qBittorrent — торрент-клиент
+- Flood — современный веб-интерфейс
+
+---
+
+## 🚀 Быстрый старт
+
+### 1. Узнать UID и GID
+
+```bash
+id -u
+id -g
+```
+
+Если используете NFS-share — для дальнейшей настройки указывайте значения из mapall user / mapall group
+
+---
+
+### 2. Настроить .env
+
+Скопируйте файл `example.env` в файл `.env` и заполните, открыв файл в текстовом редакторе
+
+```bash
+mv example.env .env
+nano .env
+```
+
+Обязательно: `UID`, `GID`, `TZ`
+Опционально: `QBT_WEBUI_PORT`, `FLOOD_WEBUI_PORT`
+
+- UID / GID — пользователь, от которого будут работать контейнеры
+- TZ — временная зона (например Europe/Moscow)
+- QBT_WEBUI_PORT — внешний порт доступа к веб-интерфейсу qBittorrent
+- FLOOD_WEBUI_PORT — внешний порт доступа к веб-интерфейсу Flood
+
+
+---
+
+### 3. Проверить структуру директорий
+
+Убедитесь, что структура директорий на хосте **создана** верно:
+
+```
+torrent/
+├── config
+├── data
+│   ├── flood
+│   └── qbittorrent
+└── media
+    ├── downloads
+    │   ├── complete
+    │   └── incomplete
+    ├── films
+    └── series
+```
+
+Важно:
+- директории должны быть созданы заранее
+- владелец должен соответствовать UID:GID
+
+Пример:
+
+```bash
+mkdir -p torrent/config
+mkdir -p torrent/data/{flood,qbittorrent}
+mkdir -p torrent/media/{downloads,films,series}
+mkdir -p torrent/media/downloads/{complete,incomplete}
+
+sudo chown -R $(id -u):$(id -g) torrent/
+```
+
+---
+
+### 4. Запуск
+
+Перейдите в директорию с docker-compose.yml:
+
+```bash
+cd torrent/config
+docker compose up -d
+```
+
+Либо:
+
+```bash
+docker compose -f path/to/torrent/config/docker-compose.yml up -d
+```
+
+---
+
+## ⚙️ Первичная настройка сервисов
+
+### qBittorrent
+
+1. Перейти по адресу `http://IP:QBT_WEBUI_PORT`
+
+2. Получить Логин/пароль:
+
+```bash
+docker logs qbittorrent
+```
+
+3. Поменять пароль
+`settings → WebUI → Password`
+
+4. Указать папку загрузок:
+`/media/downloads/complete`
+
+---
+
+### Flood
+
+1. Перейти по адресу `http://IP:FLOOD_WEBUI_PORT`
+2. Создайте аккаунт администратора
+3. Укажите данные от входа в qBittorrent
+
+---
+
+## ⚠️ Важные замечания
+
+- /media должен быть одинаковым в обоих контейнерах
+- не создавайте директории от root при использовании UID/GID
+- при NFS внимательно следите за правами
+
+---
+
+Проверено на версиях:
+qbittorrent: linuxserver/qbittorrent:5.1.4-libtorrentv1
+flood: jesec/flood:4.13.0
+
+Если что-то сломалось — используйте конкретные версии вместо latest.