# 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.