Files
media-gitops/README.md
T

100 lines
5.2 KiB
Markdown

# media-gitops
Helm chart for the media stack on the single-node cluster (`loki`), deployed by ArgoCD
via the `apps-in-apps` repo into the namespace `media`.
| App | Purpose | URL |
|---|---|---|
| Jellyfin | Media server (Intel QuickSync transcoding) | https://jellyfin.smokyzone.de |
| Seerr | Request UI (successor of Jellyseerr) | https://seerr.smokyzone.de |
| Sonarr | TV shows | https://sonarr.smokyzone.de |
| Radarr | Movies | https://radarr.smokyzone.de |
| Prowlarr | Indexer manager, syncs indexers to Sonarr/Radarr | https://prowlarr.smokyzone.de |
| SABnzbd | Usenet download client | https://sabnzbd.smokyzone.de |
| Bazarr | Subtitles | https://bazarr.smokyzone.de |
| FlareSolverr | Cloudflare challenge solver for Prowlarr (in-cluster only) | `http://flaresolverr:8191` |
The hostnames resolve to the node's private IP (`192.168.2.218`) via Cloudflare DNS-only
records, so the UIs are only reachable from the LAN or through a VPN into the LAN.
Traefik listens on the node's ports 80/443 (hostPort), so no port is needed. Access is
limited to the LAN by the Middleware `traefik/lan-only` (defined in apps-in-apps); via the
NodePort (`:30444`) requests arrive SNATed as the node's IP and are therefore refused.
Certificates come from `letsencrypt-dns-cloudflare` (DNS-01).
## Storage layout
All apps that handle files mount the node directory `/srv/media` at `/data`. Downloads
and library live on the same filesystem, so Sonarr/Radarr **hardlink** imports instead
of copying (no double disk usage):
```
/data
├── usenet
│ ├── incomplete # SABnzbd temporary folder
│ └── complete
│ ├── tv # SABnzbd category "tv"
│ └── movies # SABnzbd category "movies"
└── media
├── tv # Sonarr root folder, Jellyfin library "Serien"
├── movies # Radarr root folder, Jellyfin library "Filme"
└── anime
├── tv # Sonarr anime root folder, Jellyfin library "Anime"
└── movies # Radarr anime root folder, Jellyfin library "Anime-Filme"
```
## Languages
Configured in the apps (not in this chart):
- Sonarr/Radarr custom formats `German DL` (release title `German ... DL/ML`), `German`,
`Japanese`, `English` (language conditions). Scores add up.
- Profile `HD-1080p` (normal movies/series): German DL 2000, German 1500, English 500.
Upgrades on, until a German release is present (cutoff score 1500). Radarr profile
language is `Any` (the default `Original` would reject German releases of foreign films).
- Profile `Anime HD-1080p`: German DL 2000, German 1500, Japanese 1000, English 500.
- Seerr sends anime to the anime profile and the `anime/` root folders, with season folders.
- Jellyfin user preference: audio `ger`, subtitles `ger`, subtitle mode *Smart* (subtitles
only when the audio is not German).
The directories are created by an init container (owner `1000:1000`). Config/databases
of each app live on their own `local-path` PVC (`<app>-config`).
## First-time setup
Everything below is stored in the apps' config PVCs, not in git. In-cluster, the apps
talk to each other by service name (`http://<app>:<port>`).
1. **SABnzbd** - run the wizard, enter your Usenet provider (server, port 563, SSL).
- *Config → Folders*: Temporary `/data/usenet/incomplete`, Completed `/data/usenet/complete`.
- *Config → Categories*: `tv` → folder `tv`, `movies` → folder `movies`.
- Copy the API key (*Config → General*).
2. **Sonarr / Radarr** - set up authentication (Forms login).
- *Settings → Media Management*: root folder `/data/media/tv` (Sonarr) or
`/data/media/movies` (Radarr); keep "Use Hardlinks instead of Copy" enabled.
- *Settings → Download Clients → SABnzbd*: host `sabnzbd`, port `8080`, API key,
category `tv` / `movies`.
- Copy the API key (*Settings → General*).
3. **Prowlarr** - add your Usenet indexer(s).
- *Settings → Indexers*: add a FlareSolverr proxy (`http://flaresolverr:8191`, tag
`flaresolverr`) only if an indexer needs it.
- *Settings → Apps*: add Sonarr (`http://sonarr:8989`) and Radarr (`http://radarr:7878`)
with their API keys; Prowlarr server `http://prowlarr:9696`.
4. **Jellyfin** - run the wizard, add libraries `/data/media/tv` (Shows) and
`/data/media/movies` (Movies).
- *Dashboard → Playback → Transcoding*: Hardware acceleration **Intel QuickSync (QSV)**
(or VAAPI, device `/dev/dri/renderD128`), enable hardware decoding for H264/HEVC.
5. **Bazarr** - connect Sonarr (`sonarr:8989`) and Radarr (`radarr:7878`) with their API
keys, add subtitle providers and languages.
6. **Seerr** - sign in with Jellyfin (`http://jellyfin:8096`), then add Sonarr and Radarr
(same hosts/API keys, root folders as above).
SABnzbd only accepts whitelisted Host headers; an init container keeps `host_whitelist`
in `sabnzbd.ini` set to the ingress hostname and the in-cluster service names.
## Notes
- Jellyfin runs **privileged** to access `/dev/dri` (no GPU device plugin installed).
- Image tags are pinned; bump them in `values.yaml` to upgrade.
- The node disk is shared with the rest of the cluster. Watch free space
(`df -h /srv/media` on loki); to add a dedicated disk later, mount it at `/srv/media`.