← Alle gidsen

Jellyfin op een Synology: hardware-transcoding aanzetten (en wanneer je het beter niet kunt doen)

Je mediaserver speelt een film prima af op je laptop, maar op de tv hapert hij of blijft hij bufferen. Meestal is dat geen netwerkprobleem maar een rekenprobleem: de processor moet elk beeldje zelf omzetten. Met hardware-transcoding doet de grafische chip dat, en zakt het cpu-gebruik van 100 naar een paar procent.

Eerst eerlijk: heb je transcoding nodig?

Transcoding gebeurt alleen als het afspelende apparaat het bestand niet direct kan afspelen. Drie oorzaken komen het vaakst voor: de container of codec wordt niet ondersteund (bijvoorbeeld HEVC op een oudere tv), de ondertitels zijn ingebakken in een formaat dat de speler niet snapt, of de bitsnelheid ligt te hoog voor het apparaat.

Vuistregel: speelt je tv of mediaspeler het bestand direct af, dan heb je transcoding niet nodig. Gebeurt het vaak, dan is transcoding de oplossing – maar let op dat je cpu het haalt.

Synology NAS met Docker-containers in Portainer, waaronder Jellyfin
Mijn eigen opstelling: Jellyfin draait in een container op de NAS, naast de andere diensten.

Wat je nodig hebt

  • Een Synology met Intel- of AMD-processor. De instapmodellen met een ARM-chip (j-serie) hebben geen bruikbare hardware-transcoding.
  • Jellyfin in Docker, bij voorkeur via Portainer of docker compose.
  • Toegang tot /dev/dri op de NAS – dat is het apparaat dat de grafische chip vertegenwoordigt.
  • Een Jellyfin-account met rechten om de serverinstellingen te wijzigen.

Stap 1: controleren of je NAS het kan

Log in via SSH en kijk of het apparaat bestaat. Zonder deze stap kun je blijven proberen:

ls -l /dev/dri

Je hoopt op zoiets als card0 en renderD128. Zie je alleen card0, dan mis je de render-node en werkt transcoding niet of alleen met rechtenproblemen. Zie je helemaal niets, dan heeft je model geen bruikbare iGPU en houdt het hier op.

Stap 2: de container de chip geven

In docker compose zet je het apparaat erbij:

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    devices:
      - /dev/dri:/dev/dri
    group_add:
      - "937"          # de GID van de 'render'-groep op je NAS
    volumes:
      - ./config:/config
      - ./cache:/cache
      - /volume1/media:/media:ro
    restart: unless-stopped

De group_add is de stap die de meeste mensen overslaan. Zonder die regel heeft de container wel toegang tot het apparaat, maar geen rechten om het te gebruiken. Zoek de juiste GID op met:

getent group render

In Portainer voeg je hetzelfde toe onder "Runtime & Resources" → devices, en de GID onder "Env" of via de compose-editor.

Stap 3: in Jellyfin aanzetten

Ga naar Dashboard → Afspelen → Transcodering. Kies bij hardwareversnelling voor Intel QuickSync (QSV) of VAAPI, en vink de formaten aan die je gebruikt: H.264, HEVC, en als je die hebt ook VP9 en AV1. Laat "hardware decoding" en "hardware encoding" beide aan staan.

Jellyfin transcoderingsinstellingen met hardwareversnelling ingeschakeld
De instellingen die bij mij werken: QSV als versneller, met H.264 en HEVC aangevinkt.

Stap 4: controleren of het echt werkt

Instellingen aanzetten is niet hetzelfde als werken. Twee checks:

  • In Jellyfin: speel een bestand af dat getranscodeerd moet worden en open Dashboard → Actieve taken. Er staat "Transcoding" bij, en bij de methode zie je QSV of VAAPI in plaats van software.
  • Op de NAS: kijk met top of docker stats naar het cpu-gebruik van de container. Zakt dat naar 5–20%, dan doet de iGPU het werk. Blijft het rond de 100% hangen, dan valt hij terug op software.

Wat niet werkt (en waarom)

  • Alleen /dev/dri mounten zonder group_add. De container ziet het apparaat maar mag het niet openen, en in het logboek verschijnt iets als permission denied. Dit is de meest voorkomende fout.
  • Transcoding aanzetten op een ARM-model. De j-serie heeft geen QuickSync; de optie staat er, maar de hardware doet niets.
  • Alle formaten aanvinken "voor de zekerheid". Sommige combinaties worden door de iGPU niet ondersteund en vallen terug op software, zonder duidelijke melding. Vink aan wat je écht gebruikt.
  • Blijven zoeken in de Jellyfin-instellingen als het niet werkt. Negen van de tien keer zit het probleem in de containerconfiguratie, niet in Jellyfin.

Snel oplossen: symptoom, oorzaak, oplossing

SymptoomMeestal de oorzaakOplossing
Film hapert, cpu op 100%Terugval op software-transcoding/dev/dri en group_add controleren
Permission denied in het logboekVerkeerde of ontbrekende GIDgetent group render en die GID toevoegen
Optie ontbreekt in het menuGeen iGPU of ARM-modelNiets aan te doen; software-transcoding of een ander model
Werkt niet na een Jellyfin-updateImage zonder de juiste driversTerug naar een werkende tag en de release-opmerkingen lezen
Ondertitels zorgen voor haperingenIngebakken ondertitels forceren transcodingExterne .srt-bestanden gebruiken

Veelgestelde vragen

Hoeveel streams kan mijn NAS aan?

Met hardware-transcoding haalt een moderne Celeron of Pentium meestal twee tot vier 1080p-streams tegelijk. Bij 4K en HEVC zakt dat snel naar één. Het is geen exacte wetenschap: test het met je eigen bestanden en kijk naar docker stats.

Is transcoding slechter voor de kwaliteit?

Ja, er gaat altijd iets verloren. Daarom is "direct play" altijd beter: kies bestanden die je apparaten aankunnen. Transcoding is een vangnet, geen doel.

Kan ik dit ook op een Raspberry Pi?

De Pi heeft geen hardware-encoder. Je kunt er wel naar transcoderen, maar alleen met software, en dan houdt het bij één stream op. Voor een mediaserver is een NAS of een kleine Intel-machine een betere keuze.

Verder lezen

Nginx in Docker: 403 Forbidden en een lege pagina oplossen →