docs: fact-check sweep, Jellyfin, *arr stack, and ROM scraping guides

Fact-check results: - RomM 5.2.0: MariaDB+Redis now required (was SQLite), auth var renamed, 11 metadata providers - Copyparty v1.20.19: 3 CVEs fixed, WOPI integration, docker editions documented - Calibre-Web 0.6.27-ls397: version pinning, kepubify auto-config, CVE fixes - Calibre 9.9.0: content server security fix noted New documentation: - docs/Dankserver/Jellyfin.md — full media server guide (compose, Caddy, GPU, metadata, clients) - docs/Dankserver/ARR-Stack.md — automated download stack overview - docs/Dankserver/RomM-Scraping.md — metadata providers, naming, cover art, emulator integration - docs/Dankserver/sonarr.md, radarr.md, lidarr.md, readarr.md, prowlarr.md, qbittorrent.md - docs/Dankserver/mariadb.md, redis.md — supporting services for RomM Infrastructure updates: - dankserver/compose.yaml: added mariadb, redis, jellyfin, *arr services - dankserver/Caddyfile: added hostnames for all new services - dankserver/.env.example: added all new environment variables - docs/index.md: linked all new documentation pages Tested: 52/52 tests pass.
2026-08-20 23:40:07 -07:00
parent 34918bf309
commit e8fd009419
20 changed files with 1901 additions and 58 deletions
@@ -0,0 +1,369 @@
+# *arr Stack
+
+The *arr suite is a collection of automated media management tools for Usenet and BitTorrent. For Dankserver — which runs Copyparty, Calibre-Web, RomM, and Jellyfin — the *arr stack provides automatic downloading and library management that Copyparty alone does not cover: quality profile enforcement, series/movie discovery, metadata enrichment, and automated file organization.
+
+The core chain is: **Prowlarr** (indexer API aggregator) → **Sonarr/Radarr/Lidarr/Readarr** (media-specific managers) → **qBittorrent** (download client) → **Jellyfin** (media server scan → auto-refresh).
+
+## Service Overview
+
+| Service | Role | Image | Port | Min RAM |
+|---------|------|-------|------|---------|
+| Prowlarr | Indexer management | `lscr.io/linuxserver/prowlarr:latest` | 9696 | 256 MB |
+| Radarr | Movie management | `lscr.io/linuxserver/radarr:latest` | 7878 | 512 MB |
+| Sonarr | TV show management | `lscr.io/linuxserver/sonarr:latest` | 8989 | 512 MB |
+| Lidarr | Music management | `lscr.io/linuxserver/lidarr:latest` | 8686 | 256 MB |
+| Readarr | Ebook/audiobook management | `lscr.io/linuxserver/readarr:latest` | 8787 | 256 MB |
+| qBittorrent | Torrent download client | `lscr.io/linuxserver/qbittorrent:latest` | 8080 | 512 MB |
+| Jackett | Indexer proxy (optional) | `lscr.io/linuxserver/jackett:latest` | 9117 | 256 MB |
+| Whisparr | NSFW movie management (optional) | `lscr.io/linuxserver/whisparr:latest` | 6969 | 256 MB |
+
+**Minimum total RAM:** ~3 GB for full stack (headroom recommended).
+
+## Architecture
+
+```mermaid
+graph LR
+    I[Indexers<br/>Torrents, Usenet] --> P[Prowlarr<br/>Indexer Manager]
+    P --> S[Sonarr<br/>TV]
+    P --> R[Radarr<br/>Movies]
+    P --> L[Lidarr<br/>Music]
+    P --> Rd[Readarr<br/>Books]
+    S --> Q[qBittorrent]
+    R --> Q
+    L --> Q
+    Rd --> Q
+    Q --> M1[/tv/]
+    Q --> M2[/movies/]
+    Q --> M3[/music/]
+    Q --> M4[/books/]
+    M1 --> J[Jellyfin]
+    M2 --> J
+    M3 --> J
+    M4 --> CW[Calibre-Web]
+```
+
+## Docker Compose
+
+```yaml
+networks:
+  appnet:
+    driver: bridge
+
+services:
+  prowlarr:
+    image: lscr.io/linuxserver/prowlarr:latest
+    container_name: prowlarr
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - UMASK_SET=022
+    volumes:
+      - /opt/prowlarr/config:/config
+      - /mnt/media/downloads:/downloads:ro
+    ports:
+      - "9696:9696"
+    networks: [appnet]
+
+  radarr:
+    image: lscr.io/linuxserver/radarr:latest
+    container_name: radarr
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - UMASK_SET=022
+    volumes:
+      - /opt/radarr/config:/config
+      - /mnt/media/movies:/movies
+      - /mnt/media/downloads:/downloads
+    ports:
+      - "7878:7878"
+    networks: [appnet]
+
+  sonarr:
+    image: lscr.io/linuxserver/sonarr:latest
+    container_name: sonarr
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - UMASK_SET=022
+    volumes:
+      - /opt/sonarr/config:/config
+      - /mnt/media/tv:/tv
+      - /mnt/media/downloads:/downloads
+    ports:
+      - "8989:8989"
+    networks: [appnet]
+
+  lidarr:
+    image: lscr.io/linuxserver/lidarr:latest
+    container_name: lidarr
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - UMASK_SET=022
+    volumes:
+      - /opt/lidarr/config:/config
+      - /mnt/media/music:/music
+      - /mnt/media/downloads:/downloads
+    ports:
+      - "8686:8686"
+    networks: [appnet]
+
+  readarr:
+    image: lscr.io/linuxserver/readarr:latest
+    container_name: readarr
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - UMASK_SET=022
+    volumes:
+      - /opt/readarr/config:/config
+      - /mnt/media/books:/books
+      - /mnt/media/downloads:/downloads
+    ports:
+      - "8787:8787"
+    networks: [appnet]
+
+  qbittorrent:
+    image: lscr.io/linuxserver/qbittorrent:latest
+    container_name: qbittorrent
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - UMASK_SET=022
+    volumes:
+      - /opt/qbittorrent/config:/config
+      - /mnt/media/downloads:/downloads
+      - /mnt/media/downloads/incomplete:/downloads/incomplete
+    ports:
+      - "8080:8080"
+    networks: [appnet]
+
+  # Optional: Jackett for niche indexers
+  jackett:
+    image: lscr.io/linuxserver/jackett:latest
+    container_name: jackett
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - UMASK_SET=022
+    volumes:
+      - /opt/jackett/config:/config
+      - /opt/jackett/torrences:/torrences
+    ports:
+      - "9117:9117"
+    networks: [appnet]
+
+  # Optional: Whisparr for adult content
+  whisparr:
+    image: lscr.io/linuxserver/whisparr:latest
+    container_name: whisparr
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=America/New_York
+      - UMASK_SET=022
+    volumes:
+      - /opt/whisparr/config:/config
+      - /mnt/media/whisparr-movies:/whisparr-movies
+      - /mnt/media/downloads:/downloads
+    ports:
+      - "6969:6969"
+    networks: [appnet]
+```
+
+## Caddy Configuration
+
+```caddy
+radarr.dankserver.local {
+    reverse_proxy localhost:7878
+}
+
+sonarr.dankserver.local {
+    reverse_proxy localhost:8989
+}
+
+lidarr.dankserver.local {
+    reverse_proxy localhost:8686
+}
+
+readarr.dankserver.local {
+    reverse_proxy localhost:8787
+}
+
+prowlarr.dankserver.local {
+    reverse_proxy localhost:9696
+}
+
+qbittorrent.dankserver.local {
+    reverse_proxy localhost:8080
+}
+
+# Optional: Jackett
+jackett.dankserver.local {
+    reverse_proxy localhost:9117
+}
+
+# Optional: Whisparr
+whisparr.dankserver.local {
+    reverse_proxy localhost:6969
+}
+```
+
+## Configuration Steps
+
+### Phase 1: Download Client
+
+1. Deploy qBittorrent first (or Transmission).
+2. In the qBittorrent Web UI, set **No auth mode** for LAN (Settings → Web UI).
+3. Create download categories: `movies`, `tv`, `music`, `books`.
+4. Change the default Web UI password.
+
+### Phase 2: Indexer Management
+
+1. Deploy Prowlarr.
+2. Add indexers (3–5 recommended for testing). Use the **Test** button on each.
+3. Add qBittorrent as a download client in Prowlarr.
+4. Verify search from the Prowlarr web UI.
+
+### Phase 3: Arr Apps (one at a time)
+
+1. Deploy Sonarr first (TV shows are the most common use case).
+2. Add Prowlarr as the indexer source (Settings → Indexers → Add Prowlarr).
+3. Add qBittorrent as the download client with categories.
+4. Add a test series. Wait for the episode to download. Verify in `/tv/`.
+5. Repeat for Radarr, Lidarr, Readarr.
+
+### Phase 4: Media Server Integration
+
+1. Configure Jellyfin libraries pointing to `/movies`, `/tv`, `/music`, `/books`.
+2. Set **On Download** notifications in each arr app → Jellyfin webhook URL.
+3. Test end-to-end: Add a movie in Radarr → download → verify in Jellyfin.
+
+## Quality Profiles
+
+Each arr app uses a hierarchical quality system:
+
+1. **Quality Profile** — Defines tiers (e.g., 2160p → 1080p BluRay → 720p).
+2. **Cutoff** — The quality target. Downloads at or above cutoff are accepted.
+3. **Custom Formats** — Additional filters (e.g., "Has HDR", "Is Director's Cut").
+4. **Search on Grab** — When content becomes available, all indexers are queried.
+
+### Radarr (Movies)
+
+```
+Profile: Movies 4K
+  Tiers:
+    1. 2160p BluRay REMUX
+    2. 2160p BluRay
+    3. 2160p WEB-DL
+    4. 1080p BluRay
+    5. 1080p WEB-DL
+    6. 720p
+  Cutoff: 1080p BluRay
+```
+
+### Sonarr (TV)
+
+```
+Profile: TV - Standard
+  Tiers: 2160p → 1080p → 720p
+  Min Size: 500 MB
+  Max Size: 50 GB
+  Cutoff: 1080p
+  Language Profile: English audio preferred
+```
+
+### Lidarr (Music)
+
+```
+Profile: Music - Standard
+  Tiers: Lossless (FLAC) → 320 kbps → 192 kbps
+  Cutoff: 320 kbps (or Lossless)
+```
+
+## Metadata Sources
+
+| App | Primary Source | Secondary |
+|-----|---------------|-----------|
+| Radarr | TMDB | TheMovieDB API |
+| Sonarr | TMDB | TVDB |
+| Lidarr | MusicBrainz | — |
+| Readarr | Goodreads, StoryGraph | — |
+| Whisparr | XH | TMDB |
+
+## *arr Stack vs Copyparty
+
+| Feature | Copyparty | *arr Stack |
+|---------|-----------|------------|
+| Auto-download from torrents | Basic (RSS + scripts) | Native, integrated |
+| Quality profiles | No | Multi-tier, custom formats |
+| Series/movie tracking | No | Watch lists, air dates |
+| Manual library management | Yes | Yes, metadata-driven |
+| Multi-user watchlists | No | Yes |
+| Complexity | Low | Medium |
+| Resource usage | Minimal | Moderate |
+
+Use Copyparty for curated file collections. Use *arr for automatic downloads. Use both together for maximum functionality — point *arr download directories at Copyparty's watched folders.
+
+## Disk Layout
+
+```
+/mnt/media/
+├── movies/         → Radarr root
+├── tv/             → Sonarr root
+├── music/          → Lidarr root
+├── books/          → Readarr root
+├── whisparr-movies/ → Whisparr root
+├── downloads/      → qBittorrent download dir
+│   ├── movies/
+│   ├── tv/
+│   ├── music/
+│   └── books/
+└── incomplete/     → qBittorrent incomplete downloads
+```
+
+## Gotchas
+
+- **Timezone mismatch:** All containers should use the same TZ. Sonarr's scheduler is timezone-sensitive.
+- **File permissions:** Set `umask=022` in qBittorrent. Ensure arr apps can read/move downloaded files.
+- **Network conflicts:** *arr apps use many ports. Check for conflicts with existing Dankserver services.
+- **Prowlarr API key rotation:** If rotated, update it in every arr app.
+- **qBittorrent Web UI password:** Change default on first run.
+- **Readarr stability:** Readarr is still in development. Do not rely on it for mission-critical collections.
+- **Whisparr separate Jellyfin library:** Keep adult content separate from regular media.
+- **RSS feed in qBittorrent:** Can auto-add torrents matching a pattern. Useful for podcast-like series.
+
+## Best Practices
+
+1. Use tags to route content to specific download clients or categories.
+2. Enable the Blocklist in arr apps to prevent re-downloading failed torrents.
+3. Set download limits in qBittorrent to avoid bandwidth saturation.
+4. Back up arr configs regularly (they are small SQLite DBs + JSON).
+5. Monitor Prowlarr indexer health — broken indexers hide new content.
+6. Start with default quality profiles. Add custom formats gradually.
+7. Back up arr configs: `./radarr/config`, `./sonarr/config`, etc.
+
+## See Also
+
+- [[Dankserver Stack]]
+- [[Jellyfin]] — media server that consumes *arr downloads
+- [[Copyparty]] — alternative file viewer
+- [[Calibre-Web]] — manual ebook management (Readarr auto-downloads into the same library)
+- [[Sonarr Wiki]] — https://wiki.servarr.com/sonarr
+- [[Radarr Wiki]] — https://wiki.servarr.com/radarr