Jellyfin server in docker op de QNAP nas

 Complete setup Jellyfin op QNAP

Ik ga uit van de volgende zaken:

de QNAP heeft een intel processor. in mijn geval een Intel celeron. En een externe USB harddisk met daarop de jellyfin film bestanden op share/external/DEV3303_1

Als dat jij jouw systeem anders is, dien je de opdrachten dienovereenkomstig aan te passen.

Log in met SSH in het admin account. Vaak moet je dat activeren, omdat dat op veel QNAP nas apparaten is uitgezet. Doe dat in Control Panel, Bevoegdheden, gebruikers en klik dan op het knopje "wijzig gebruikers profiel"achter admin als deze de status uitgeschakeld heeft.

Onder rnetwerk en bestandsservice staat telnet/SSH waar je de SSH service kunt aanzetten. Daarna kun je met een programma zoals remmina inloggen in een SSH sessie van de NAS. de commando'sdie hier staan genoteerd worden gegeven in deze SSH omgeving.

Mappen aanmaken voor config en cachecd /share/Container

mkdir -p jellyfin/config

mkdir -p jellyfin/cache

Hier slaat Jellyfin zijn instellingen en cache op

Altijd persistent, dus updates van Docker vernietigen deze mappen niet

Controleer USB-schijf

Je USB-schijf zit in mijn geval op /share/external/DEV3303_1.
Controleer:

ls /share/external/DEV3303_1

Je zou de films en mappen moeten zien

Geen extra mount nodig, Docker kan er direct bij als we PUID/PGID op 0 zetten

check of er hardware transcoding mogelijk is:

Aangezien je een Intel-processor hebt, kun je hardware-versnelling gebruiken.

1. Zorg dat /dev/dri beschikbaar is op je NAS:

ls /dev/dri

Als je 




card0  renderD128 

ziet dan zit je goed en moet je deze regel ook gebruiken:

devices:

  - /dev/dri:/dev/dri

in Jellyfin zelf activeer je de hardware versnelling straks met:

• Ga naar Instellingen → Afspelen → Transcodering

• Zet “Hardware Acceleration” aan → kies “Intel QuickSync”

Maar nu eerst:

Maak docker-compose.yml aan

Ga naar de Jellyfin-map:

cd /share/Container/jellyfin

Maak het bestand:

vi docker-compose.yml

Druk i om insert mode te starten

Plak dit:

version: "3.9"

services:

  jellyfin:

    image: jellyfin/jellyfin:latest

    container_name: jellyfin

    environment:

      - TZ=Europe/Amsterdam

      - PUID=0

      - PGID=0

    volumes:

      - ./config:/config

      - ./cache:/cache

      - /share/external/DEV3303_1:/media

    devices:

      - /dev/dri:/dev/dri

    ports:

      - "8096:8096"

    restart: unless-stopped

Opslaan en vi verlaten:

1. Druk Esc

2. Typ :wq

3. Druk Enter

de regels 

devices:

      - /dev/dri:/dev/dri

alleen  gebruiken als je eerder met

ls /dev/dri

dit als output kreeg:




card0  renderD128 

Zo niet, dan laat je die twee regels weg.

Container starten

docker compose up -d

• Docker downloadt de laatste Jellyfin image
• Container draait op poort 8096
• /media verwijst naar je USB-schijf
• Intel QuickSync hardware-transcodering is actief

Controleer:

docker ps

Jellyfin configureren via browser

Open:

http://<NAS-IP>:8096

1. Doorloop setup-wizard → admin account

2. Voeg mediabibliotheek toe → pad: /media

3. Hardware-transcodering aanzetten:

   • Instellingen → Afspelen → Transcodering → Hardwareversnelling

   • Kies Intel QuickSync (VAAPI)

Test met een film → Dashboard → Activiteit → “Hardware acceleration: Yes (QSV)”

Updates van Jellyfin uitvoeren

Dankzij docker-compose is het eenvoudig:

• Stop oude container (optioneel, meestal niet nodig)

docker compose down

• Download nieuwste Jellyfin image:

docker compose pull

• Herstart container:

docker compose up -d

Alle instellingen en cache blijven behouden in config en cache mappen

Container draait weer met de nieuwe versie

Handige extra commando’s

• Logs bekijken:

docker compose logs -f

• Container stoppen:

docker compose stop

• Container verwijderen (zonder data):

docker compose rm

• Containers en images schoonmaken:

docker system prune -a

Tips voor QNAP

• Gebruik altijd /share/Container of /share/Public voor Docker volumes, nooit /share/system

• PUID=0 en PGID=0 geeft volledige toegang tot USB-schijf

• Config- en cache-mappen zorgen dat updates veilig zijn

• Docker Compose maakt toekomstige updates en beheer supersimpel