# External ARR Stack

This Docker Compose stack runs the media-management apps outside Kubernetes on
the Debian host. It is not called by `jeannie` 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

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