Files
memory/systems/jellyfin.md
T
2026-10-19 22:00:05 +00:00

4.4 KiB

title, category, tags, created, modified
title category tags created modified
Jellyfin Media Server systems
jellyfin
media
kubernetes
vaapi
swiftfin
2026-10-19 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-<datum>/, 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/<scan-id> (Task-Id via GET /ScheduledTasks, Name „Scan Media Library").
  • Neue Medien landen automatisch via SABnzbd-Sorter in /media/<Serie>/ (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.
  • 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