my-homelab-configs/infra/arr-stack/README.md

50 lines
1.2 KiB
Markdown

# External ARR Stack
This Docker Compose stack runs the media-management apps outside Kubernetes on
the Debian host. It is not called by `lab.sh` and is not part of the homelab
OpenTofu/Argo pipeline.
Services:
- Prowlarr: `9696`
- Radarr: `7878`
- Sonarr: `8989`
- qBittorrent: `8080`
- FlareSolverr: `8191`
- Kapowarr: `5656`
- Suwayomi: `4567`
- Maintainerr: `6246`
Persistent storage defaults to `/data/arr`.
## Start
```bash
cd infra/arr-stack
cp .env.example .env
./bootstrap.sh
```
The helper creates `/data/arr`, fixes ownership for `PUID`/`PGID`, and starts
the Compose stack.
## Manage
```bash
docker compose --env-file .env -f docker-compose.yml ps
docker compose --env-file .env -f docker-compose.yml logs -f
docker compose --env-file .env -f docker-compose.yml pull
docker compose --env-file .env -f docker-compose.yml up -d
docker compose --env-file .env -f docker-compose.yml down
```
`down` stops containers but keeps `/data/arr` intact.
## Bootstrap
See `docs/bootstrap.md` for path wiring and safe import-list guidance.
After the first boot and API-key discovery, `./configure-arr.py` can configure
Radarr/Sonarr root folders and qBittorrent download clients without putting
credentials in Git.