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

1.4 KiB

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.

Containers use explicit DNS servers from .env through ARR_DNS_PRIMARY and ARR_DNS_SECONDARY. Defaults are 1.1.1.1 and 8.8.8.8; set them to your router, Pi-hole, or Tailscale DNS addresses if needed.

Start

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

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.