--- title: Jellyfin Media Server category: systems tags: [jellyfin, media, kubernetes, vaapi, swiftfin] created: "2026-10-19" modified: "2026-10-19" --- # Jellyfin (Media Server) ## Überblick Selbst gehosteter Medienserver für die Adult-Szenen-Bibliothek (Kink.com/Series + Erika Lust), Abspielziel AppleTV via **Swiftfin**. | Fakultät | Wert | |---|---| | Version | `jellyfin/jellyfin:12.2` (Tag gepinnt, nie `latest`) | | Namespace | `sabnzbd` (Co-Lokation wegen RWO-Mount der sabnzbd-PVC) | | Node-Pin | `rke2-worker-05` (einziger iGPU-Node, `/dev/dri/renderD128`, GID 991, `privileged: true`) | | VIP | **10.0.30.209:8096** (Cilium LB-IPAM, Annotation `io.cilium/lb-ipam-ips`) | | Config-PVC | `jellyfin-config` 5Gi RWO ceph-hdd-replica | | Media-Mount | sabnzbd-PVC **read-only** auf `/media` (= `/config/downloads/media` im SABnzbd-Pod) | | Manifeste | `iac-homelab/clusters/main/jellyfin/` + App `clusters/main/apps/jellyfin.yaml` | | NetworkPolicy | CNP `jellyfin-lan-only` (world/host/remote-node auf 8096 — VIP-Ingress kommt durch SNAT als `world` an, s. Cilium-Traps) | | Admin-Login | 1P-Item **„Jellyfin Login dominik"** (Vault Kubernetes ESO), User `dominik`, IsAdministrator | ## Bibliothek - Library **„Mediathek"** (`collectionType=homevideos`), Pfad `/media`, 6 Serienordner als Folder: DeviceBondage (8), DungeonSex (26), ErikaLust (5), SexAndSubmission (36), TheTrainingOfO (6), TheUpperFloor (25) — **106 Videos, verifiziert 19.10.**. - **Kollaps-Falle**: Movies-Typ fasst mehrere Dateien pro Ordner zu 1 Film + unsichtbaren Extras zusammen. Szenen-Bibliotheken besser als `homevideos` oder untypisiert anlegen (zeigen jede Datei einzeln; NFO-Parsing identisch). - **Zombie-Items-Falle**: Alte Movie-Items auf gleichen Pfaden überleben Library-Delete+Recreate in `jellyfin.db` (pfadbasiertes Keying) und lassen jeden Scan leer laufen („Validating" ohne Enumeration). Heilung: Full-DB-Reset — ArgoCD selfHeal aus, scale 0, `mv /config/data/jellyfin.db* /config/dbbackup-/`, Wizard-Flag reset, Neu-Bootstrap. Backup: `/config/dbbackup-20261019/` auf jellyfin-config-PVC. - NFOs (Kodi-Stil, vom SABnzbd-Sorter generiert) werden gelesen: Title/Plot/Genre/Studio/Actors/Year verifiziert. - Scheduled Tasks „Extract Chapter Images" + „Generate Trickplay Images" + „Migrate Trickplay" haben **leere Trigger** (RO-Media-Mount darf nie beschrieben werden). ## API-Fallen (12.2) — Details: Solution Doc s.u. 1. Auth-Header heißt jetzt **`Authorization: MediaBrowser ...`** (nicht mehr `X-Emby-Authorization` → sonst 400 ArgumentNullException). 2. `/Startup/User` nimmt `{"Name","Password"}` — Feld `Username` → täuschende 404. **Route funktioniert anonym NUR OHNE Authorization-Header** (mit MediaBrowser-Header trotz korrektem Payload ebenfalls 404!). Vorsicht: Probe-POSTs legen echte Admin-User an; Route acceptiert nur EINEN Startup-User (danach 403). `GET /Startup/User` = DTO-Sonde (zeigt Seed-User `root`). 3. Bootstrap-Reihenfolge: Configuration → Startup/User → **erst dann** `/Startup/Complete` (sonst Lockout; Recovery via `system.xml` `IsStartupWizardCompleted=false` + Pod-Restart). 4. Tasks: Trigger-Update `POST /ScheduledTasks/{id}/Triggers`, Ausführen `POST /ScheduledTasks/Running/{id}` (PUT/alte Route → 405; `OPTIONS` zeigt Allow). 5. Null-Users-Boot seedet automatisch User `root` ohne Passwort (Login trotzdem 401 — ignorierbar). ## Swiftfin / AppleTV - **UDP-Autodiscovery funktioniert durch den K8s-VIP nicht** → im Client Server MANUELL eintragen: `http://10.0.30.209:8096`, User `dominik`. - Transcode: VAAPI auf worker-05 verfügbar (Hardware-Encoder vorhanden, Jellyfin-Transcodierung ungetestet 19.10.). ## Betrieb - Scan anstoßen: `POST /ScheduledTasks/Running/` (Task-Id via `GET /ScheduledTasks`, Name „Scan Media Library"). - Neue Medien landen automatisch via SABnzbd-Sorter in `/media//` (Postproc-Skript, CM `sabnzbd-postproc-script`). - Bekannte Data-Hygiene-Aufgabe (19.10.): Alt-Salvage-MKVs (~600 MB 720p) liegen neben frischen 1080p/4K-MP4s derselben Szene (8 Paare in DeviceBondage, ~5 GB); Löschung nur nach GO. ## Related Solution Docs - `docs/solutions/integrations/2026-10-19-jellyfin-12-bootstrap-api-breaking-changes.md` - `docs/solutions/bug-fixes/2026-10-19-cilium-networkpolicy-four-traps.md` ## Verwandte Wiki-Seiten - [[systems/sabnzbd]] — Downloader, Sorter, Media-PVC-Owner - [[systems/rke2-kubernetes]] — Cluster, LB-IPAM - [[reference/ip-map]]