{"id":531,"date":"2026-10-06T14:20:00","date_gmt":"2026-10-06T12:20:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/?page_id=531"},"modified":"2026-09-25T15:07:52","modified_gmt":"2026-09-25T13:07:52","slug":"verzogerungsfreier-lokaler-medienserver-jellyfin-auf-raspberry-pi-5","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/de\/raspberry-pi-de\/tutorials-de-raspberry-pi-de\/verzogerungsfreier-lokaler-medienserver-jellyfin-auf-raspberry-pi-5\/","title":{"rendered":"Verz\u00f6gerungsfreier lokaler Medienserver: Jellyfin auf Raspberry Pi 5 mit Hardware-Beschleunigung"},"content":{"rendered":"

Architektur-\u00dcberblick: Mediendekodierung auf dem Raspberry Pi 5<\/h2>\n

Das Hosting eines selbstverwalteten Video-Streaming-Servers auf einem Raspberry Pi war historisch oft durch Leistungsenzp\u00e4sse bei der Echtzeit-Transkodierung limitiert. Nicht unterst\u00fctzte Codecs, inkompatible Tonspuren oder begrenzte Netzwerkbandbreiten zwingen den Medienserver dazu, Videobilder zur Laufzeit zu dekodieren und neu zu kodieren. Auf generischen ARM-Prozessorkernen f\u00fchrt die rein softwarebasierte Transkodierung von hochaufl\u00f6senden HEVC-(H.265-) oder 4K-Dateien schnell zur Auslastung der CPU, was thermisches Drosseln und Ruckeln beim Abspielen verursacht.<\/p>\n

Der Raspberry Pi 5 (basierend auf dem Broadcom-BCM2712-SoC) dekodiert in Hardware allein HEVC, und dieser Decoder ist zustandslos: Er wird \u00fcber die V4L2-Request-API angesprochen, nicht \u00fcber zustandsbehaftete V4L2-M2M-Decoder wie hevc_v4l2m2m<\/code>. Jellyfin<\/strong> nutzt ihn nicht: Die Option \u201eVideo4Linux2\u201c setzt allein V4L2-Encoder wie h264_v4l2m2m<\/code> ein, und einen Encoder hat der Pi 5 nicht; die V4L2-Unterst\u00fctzung f\u00fcr den Raspberry Pi hat das Projekt zudem abgek\u00fcndigt. Als Container betrieben, dekodiert und kodiert Jellyfin auf dem Pi 5 deshalb in Software auf den vier ARM-Cortex-A76-Kernen; ein niedriger Stromverbrauch gilt f\u00fcr Direct Play und nicht f\u00fcr das Transkodieren.<\/p>\n

\n\"Dreischichtiges
Auf dem Pi 5 transkodiert Jellyfin in Software: V4L2 ist f\u00fcr den Pi abgek\u00fcndigt, die Hardwarebeschleunigung steht auf \u201eKeine\u201c, und den zustandslosen HEVC-Decoder nutzt Jellyfin nicht \u2014 schnell und sparsam bleibt nur Direct Play.<\/figcaption><\/figure>\n

Schritt-f\u00fcr-Schritt-Implementierungsanleitung<\/h2>\n

Schritt 1: Betriebssystem-Vorbereitung und Pr\u00fcfung der DRM-Ger\u00e4teanbindung<\/h3>\n

Eine 64-Bit-Installation von Raspberry Pi OS Lite ist erforderlich, um die Kompatibilit\u00e4t mit den 64-Bit-FFmpeg-Hardwarebibliotheken zu gew\u00e4hrleisten; aktuelle Images basieren seit Oktober 2025 auf Debian 13 (Trixie), Debian 12 (Bookworm) gilt als Mindestversion. Vor der Einrichtung der Container-Laufzeitumgebung muss das Vorhandensein der Direct-Rendering-Manager-(DRM-)Schnittstellen im Terminal \u00fcberpr\u00fcft werden:<\/p>\n

ls -l \/dev\/dri<\/code><\/pre>\n
Eine funktionsf\u00e4hige Systemausgabe zeigt die Grafikkarten- und Render-Knoten (card0<\/code>, card1<\/code>, renderD128<\/code>) an. Damit Docker-Container auf diese Grafikknoten zugreifen d\u00fcrfen, muss die korrekte Gruppenzugeh\u00f6rigkeit konfiguriert sein:<\/p>\n
sudo usermod -aG video,render \"$USER\"<\/code><\/pre>\n
Schritt 2: NVMe-Speicheranbindung und Verzeichnisstruktur<\/h3>\n
F\u00fcr schnelle Bibliotheksscans und reibungslose Daten\u00fcbertragungsraten sollten die Mediendateien auf einer NVMe-SSD (\u00fcber PCIe 2.0\/3.0) oder auf einem UASP-f\u00e4higen USB-3.0-Speichersystem liegen. Unter \/opt\/containers\/jellyfin\/<\/code> wird eine strukturierte Ordnerhierarchie erstellt:<\/p>\n
mkdir -p \/opt\/containers\/jellyfin\/{config,cache}\nmkdir -p \/mnt\/media\/{movies,series}\nchmod -R 755 \/mnt\/media<\/code><\/pre>\n
Schritt 3: Konfiguration des deklarativen Docker-Compose-Stacks<\/h3>\n
Die Container-Orchestrierung wird in der Datei \/opt\/containers\/jellyfin\/docker-compose.yml<\/code> konfiguriert. Das Host-Verzeichnis \/dev\/dri<\/code>, das eine Hardwarebeschleunigung br\u00e4uchte, wird in den Container gemappt, auf dem Pi 5 nur vorsorglich (siehe Schritt 4); der Container-Prozess l\u00e4uft \u00fcber user<\/code> unter einer festen Benutzer-ID und tritt \u00fcber group_add<\/code> zus\u00e4tzlich den Host-Gruppen render<\/code> und video<\/code> anhand ihrer numerischen GIDs bei:<\/p>\n
services:\n  jellyfin:\n    image: jellyfin\/jellyfin:latest\n    container_name: jellyfin\n    restart: unless-stopped\n    user: \"1000:1000\"\n    group_add:\n      - \"44\"  # Durch die numerische Host-GID der Gruppe 'video' ersetzen\n      - \"109\" # Durch die numerische Host-GID der Gruppe 'render' ersetzen\n    network_mode: \"host\"\n    environment:\n      - JELLYFIN_PublishedServerUrl=http:\/\/jellyfin.lukaswojcik.com\n    volumes:\n      - \"\/opt\/containers\/jellyfin\/config:\/config\"\n      - \"\/opt\/containers\/jellyfin\/cache:\/cache\"\n      - \"\/mnt\/media:\/media:ro\"\n    devices:\n      - \"\/dev\/dri:\/dev\/dri\"\n    security_opt:\n      - no-new-privileges:true<\/code><\/pre>\n
Technischer Hinweis:<\/em> Der Einsatz von network_mode: \"host\"<\/code> maximiert den Datendurchsatz im Netzwerk und erm\u00f6glicht die automatische DLNA-\/UPnP-Ger\u00e4teerkennung im Heimnetzwerk ohne komplexe Port-Forwarding-Regeln.<\/p>\n
Schritt 4: Transkodierungseinstellungen im Jellyfin-Dashboard<\/h3>\n
Nach dem Start des Stacks mittels docker compose up -d<\/code> wird die Transkodierung in der grafischen Administrationsoberfl\u00e4che von Jellyfin eingestellt:<\/p>\n
    \n
  1. Das Webinterface unter http:\/\/<Raspberry-Pi-IP>:8096<\/code> aufrufen und zu Dashboard → Wiedergabe → Transkodierung<\/strong> navigieren.<\/li>\n
  2. Im Dropdown-Men\u00fc f\u00fcr Hardwarebeschleunigung<\/strong> keine Beschleunigung ausw\u00e4hlen. Video4Linux2 (V4L2)<\/strong> bringt auf dem Pi 5 nichts: Jellyfin verwendet dar\u00fcber nur V4L2-Encoder, dem BCM2712 fehlt jeder Videoencoder, und die Jellyfin-Dokumentation f\u00fchrt V4L2 f\u00fcr den Raspberry Pi als abgek\u00fcndigt. Einen Eintrag OpenMAX\/OMX gibt es nicht mehr: Jellyfin hat ihn entfernt, und aus Raspberry Pi OS ist die OMX-Schnittstelle seit Bullseye verschwunden.<\/li>\n
  3. Kontrollk\u00e4stchen f\u00fcr eine Hardwaredekodierung sind damit nicht zu setzen. Den einzigen Hardware-Decoder des SoC, den f\u00fcr HEVC<\/strong>, spricht Jellyfin nicht an, und die H.264-, MPEG-2- und MPEG-4-Decoder des Raspberry Pi 4 fehlen dem BCM2712 ganz; alle Formate werden auf den Cortex-A76-Kernen in Software dekodiert.<\/li>\n
  4. Den FFmpeg-Pfad<\/strong> auf \/usr\/lib\/jellyfin-ffmpeg\/ffmpeg<\/code> festlegen und die Konfiguration speichern.<\/li>\n<\/ol>\n
    Schritt 5: Qualit\u00e4tssicherung und Audit der Echtzeit-Transkodierung<\/h3>\n
    Wie stark das Transkodieren die CPU belastet und ob Jellyfin \u00fcberhaupt neu kodiert, zeigt eine \u00dcberpr\u00fcfung w\u00e4hrend eines aktiven Video-Streams:<\/p>\n
      \n
    1. Transkodierten Stream starten:<\/strong> Eine HEVC-(H.265-)10-Bit-Videodatei im Webbrowser aufrufen, der kein natives H.265 unterst\u00fctzt, um eine Transkodierung zu H.264 zu erzwingen. Dekodierung und Kodierung laufen dabei in Software: Jellyfin nutzt den HEVC-Decoder des Pi 5 nicht, und der BCM2712 enth\u00e4lt \u00fcberhaupt keinen Videoencoder, das H.264-Encoding \u00fcbernimmt libx264 auf der CPU.<\/li>\n
    2. CPU-Auslastung im Terminal pr\u00fcfen:<\/strong> In einer SSH-Sitzung auf dem Raspberry Pi das Tool htop<\/code> oder top<\/code> ausf\u00fchren. Da Dekodierung und Kodierung in Software erfolgen, ist eine hohe Last auf allen vier Kernen in diesem Szenario zu erwarten und kein Zeichen einer fehlerhaften Einrichtung. Niedrige CPU-Werte ergeben sich erst ohne Neukodierung, also bei Direct Play. Dass der HEVC-Decoder selbst arbeitet, zeigt nur ein Dekodiertest au\u00dferhalb von Jellyfin mit dem FFmpeg aus Raspberry Pi OS auf dem Host, etwa ffmpeg -hwaccel drm -i datei.mkv -f null -<\/code>.<\/li>\n
    3. Transkodierungs-Logs analysieren:<\/strong> Die Logdateien unter \/opt\/containers\/jellyfin\/config\/log\/ffmpeg-transcode-*.txt<\/code> \u00f6ffnen: Ein Decoder wie hevc_v4l2m2m<\/code> erscheint dort nicht, weil Jellyfin f\u00fcr V4L2 keinen Decoder setzt. Aufschlussreich ist der Eintrag hinter -codec:v:0<\/code>: libx264<\/code> steht f\u00fcr eine Neukodierung des Bildes, copy<\/code> f\u00fcr blo\u00dfes Umverpacken.<\/li>\n<\/ol>\n
      Zusammenfassung und resultierender Mehrwert<\/h2>\n
      Was sich damit erreichen l\u00e4sst:<\/strong> Die Bereitstellung eines containerisierten, selbstgehosteten Jellyfin-Medienservers auf einem Raspberry Pi 5, der Videodateien per Direct Play ausliefert und bei Bedarf in Software transkodiert.<\/p>\n
      Resultierender Mehrwert:<\/strong><\/p>\n