servarr-stack

Docker Compose para o ecossistema Servarr (*Arr) e companions: Bazarr, FlareSolverr, qBittorrent, Plex, Seerr, Wizarr, Tautulli, Profilarr, Unpackerr, Kometa, Tdarr, Maintainerr e Homepage.

Objetivo de instalação: configuração de fábrica (wiring + indexers quando importados) com biblioteca vazia - nenhum filme, série, música ou livro monitorado; nada na fila do Bazarr. Mídia e catálogo entram depois, no uso.

Destino previsto: Servidor Pessoal / Notebook Servidor com Portainer (ver docs/PORTAINER.md). Ainda não é obrigatório subir lá.

Serviços

Serviço	Função	Porta	Hostname
Prowlarr	Indexers	9696	prowlarr
Sonarr	Séries	8989	sonarr
Radarr	Filmes	7878	radarr
Lidarr	Música	8686	lidarr
Readarr	Livros (develop)	8787	readarr
Whisparr	Adulto (hotio)	6969	whisparr
Bazarr	Legendas	6767	bazarr
FlareSolverr	Cloudflare	8191	flaresolverr
qBittorrent	Torrents	8080	qbittorrent
Unpackerr	Extrai .rar/.zip	-	unpackerr
Plex	Media server	32400	plex
Seerr	Pedidos de mídia	5055	seerr
Wizarr	Convites / onboarding	5690	wizarr
Tautulli	Métricas do Plex	8181	tautulli
Profilarr	Sync TRaSH profiles	6868	profilarr
Kometa	Coleções / overlays Plex	-	kometa
Tdarr	Transcode	8265 / 8266	tdarr
Maintainerr	Limpeza de biblioteca	6246	maintainerr
Homepage	Dashboard	3000	homepage

qBittorrent e FlareSolverr ficam na rede servarr. Nos *Arr, use os hostnames qbittorrent e flaresolverr.

Alternativas deixadas de fora de propósito: Recyclarr (Profilarr cobre), Homarr (Homepage cobre), Deleterr (Maintainerr cobre), Ombi/Petio/Jackett/Autobrr/Cross-Seed/Requestrr. VPN embutida (Gluetun) foi removida para o stack subir sem secrets de provedor.

Pré-requisitos

• Docker Engine + Docker Compose v2 (ou Portainer com Compose)
• Disco único (mesmo filesystem) para DATA_ROOT - hardlinks
• python3 no host para scripts/configurar-fabrica.sh

Subir o stack

cp .env.example .env
# Ajuste PUID/PGID/TZ, paths, HOMEPAGE_ALLOWED_HOSTS

id -u && id -g

bash scripts/init-dirs.sh
docker compose up -d

qBittorrent (linuxserver): usuario admin; senha no log (copie para QBITTORRENT_PASSWORD no .env):

docker compose logs qbittorrent | grep -i password

Plex: claim em plex.tv/claim -> PLEX_CLAIM no .env (expira em minutos).

Configuração de fábrica

Depois que os containers estiverem healthy:

# opcional: export QBITTORRENT_PASSWORD='...'
bash scripts/configurar-fabrica.sh

O script (scripts/configurar-fabrica.py + config/fabrica/defaults.json):

• Cria root folders vazios nos *Arr (/data/media/...)
• Cadastra qBittorrent (host qbittorrent) e categorias
• Liga hardlink
• Registra FlareSolverr no Prowlarr e sync Prowlarr -> *Arr
• Tenta ligar Bazarr a Sonarr/Radarr sem popular Wanted de catálogo antigo
• Imprime checklist do que falta na UI (Profilarr, Plex libraries vazias, Seerr, Wizarr, etc.)

Não adiciona títulos monitorados. Indexers com secrets: importe backup local (config/fabrica/prowlarr-indexers.example.json como modelo) - não versionar cookies/API keys.

Detalhes: config/fabrica/README.md.

Portainer

Quando for a hora no Servidor Pessoal: docs/PORTAINER.md.

Resumo: Stack a partir do Git (docker-compose.yml + env vars do .env.example), paths absolutos em CONFIG_ROOT / DATA_ROOT, depois configurar-fabrica.sh no host.

Estrutura de pastas (TRaSH)

data/
  torrents/{incomplete,movies,tv,music,books,xxx}/
  media/{movies,tv,music,books,xxx}/
  tdarr-temp/
config/
  fabrica/            # defaults versionados da configuração de fábrica
  prowlarr/ sonarr/ radarr/ lidarr/ readarr/ whisparr/
  bazarr/ qbittorrent/ plex/ seerr/ wizarr/ tautulli/ profilarr/
  kometa/ tdarr/ maintainerr/ homepage/

Referência: TRaSH - File and Folder Structure.

Como linkar os apps (UI) - referência

O script de configuração de fábrica cobre a maior parte do wiring. Se precisar na mão:

1. FlareSolverr no Prowlarr: http://flaresolverr:8191/
2. Prowlarr -> Apps: http://sonarr:8989, http://radarr:7878, http://lidarr:8686, http://readarr:8787, http://whisparr:6969
3. Download client nos *Arr: host qbittorrent, porta 8080
4. Categorias qBittorrent: tv/movies/music/books/xxx -> /data/torrents/<cat>
5. Root folders: /data/media/tv|movies|music|books|xxx (vazios no início)
6. Bazarr: http://sonarr:8989 e http://radarr:7878
7. Profilarr: sync TRaSH em Sonarr/Radarr
8. Seerr / Wizarr / Tautulli / Kometa / Tdarr / Maintainerr / Homepage: ver checklist do script

Unpackerr

Coloque as API keys no .env (SONARR_API_KEY, etc.) e recrie o container:

docker compose up -d unpackerr

Diagrama

Wizarr (convite) ----------------> Plex usuários
                                      ^
Seerr (pedidos) --> Sonarr/Radarr ----+
                      |
                 qBittorrent
                      |
                 Unpackerr (se .rar)
                      |
                 /data/media <--+-- Bazarr
                      |         +-- Tdarr
                      |         +-- Kometa / Maintainerr
                      v
                    Plex <--> Tautulli
                      ^
                 Homepage (atalhos)
Profilarr --> Sonarr/Radarr (TRaSH profiles)
configurar-fabrica --> wiring *Arr / Prowlarr / qBit / Bazarr

Comandos úteis

docker compose ps
docker compose logs -f qbittorrent
docker compose pull && docker compose up -d
bash scripts/configurar-fabrica.sh
docker compose down

Notas

• DATA_ROOT em um único filesystem.
• Readarr: tag develop. Whisparr: hotio.
• Instalação nova = catálogo vazio; só configuração e (opcionalmente) indexers.
• Lista de tools oficiais: https://wiki.servarr.com/useful-tools