How to activate Intel Quick Sync in docker (Jellyfin, Handbrake,...)

chente · Apr 5th 2021

I post this because I have not found a clear guide to do it, and after going around a lot and trying things in the end it turned out well. If there is already a guide for this, sorry, I have not found it, that some moderator delete the thread.

FIRST:

Have a CPU with Intel Quick Sync technology... obvious...

see:

https://en.wikipedia.org/wiki/Intel_Quick_Sync_Video

https://ark.intel.com/content/…873&0_QuickSyncVideo=True

SECOND:

Install the drivers

It has worked for me with VA-API, see https://github.com/intel/intel-vaapi-driver

There are several drivers depending on the CPU, look for the correct one.

Install via console:

Code

apt install intel-media-va-driver

optional install vainfo to check the result

Code

apt install vainfo

and then run

Code

vainfo

The system will spit out the graphical settings.

THIRD:

And finally include the graphical configuration in docker. I have done it using stacks, I put two examples, jellyfin and handbrake, both have worked for me. They are illustrative examples, each one must adapt them to their particular case, there is a lot of documentation on this.

The key is these two lines, which inform the docker where the graph is:

Code

    devices:
      - /dev/dri/renderD128:/dev/dri/renderD128
      - /dev/dri/card0:/dev/dri/card0

For Handbrake:

Code

---
version: "2"
services:
  handbrake:
    image: jlesage/handbrake
    container_name: handbrake
    ports:
      - 5800:5800
    volumes:
      - /srv/dev-disk-by-uuid-c31ebfea-c15a-4f78-823c-9410fae65531/archivos_de_sistema/config/handbrake:/config:rw
      - /srv/8c3a6c3a-7f82-4821-98ae-dcc3b6238171/descargas:/storage:ro
      - /srv/dev-disk-by-uuid-c31ebfea-c15a-4f78-823c-9410fae65531/archivos_comprimidos:/output:rw
    devices:
      - /dev/dri/renderD128:/dev/dri/renderD128
      - /dev/dri/card0:/dev/dri/card0
    restart: unless-stopped

Display More

For Jellyfin:

Code

---
version: "2.1"
services:
  jellyfin:
    image: ghcr.io/linuxserver/jellyfin
    container_name: jellyfin
    environment:
      - PUID=1002
      - PGID=100
      - TZ=Europe/Madrid
    volumes:
      - /srv/dev-disk-by-uuid-c31ebfea-c15a-4f78-823c-9410fae65531/archivos_de_sistema/config/jellyfin:/config
      - /srv/8c3a6c3a-7f82-4821-98ae-dcc3b6238171/fotos:/datos/fotos
      - /srv/8c3a6c3a-7f82-4821-98ae-dcc3b6238171/musica:/datos/musica
      - /srv/8c3a6c3a-7f82-4821-98ae-dcc3b6238171/descargas:/datos/descargas
      - /srv/8c3a6c3a-7f82-4821-98ae-dcc3b6238171/peliculas:/datos/peliculas
      - /srv/8c3a6c3a-7f82-4821-98ae-dcc3b6238171/series:/datos/series
    devices:
      - /dev/dri/renderD128:/dev/dri/renderD128
      - /dev/dri/card0:/dev/dri/card0
    ports:
      - 8096:8096
    restart: unless-stopped

Display More

Note: In the case of Jellyfin, I previously assigned the user I use for that docker to the video and render groups. I don't know if this is necessary but I'm not going to touch it now that it works

RESULT:

Handbrake encoding video on the NAS in 7.5 times less time than without Quick Sync.

Jellyfin streaming 4K encoded video at 10% CPU.

NAS administrator, you don't have time to queue videos from Handbrake.

How to activate Intel Quick Sync in docker (Jellyfin, Handbrake,...)

crashtest Apr 5th 2021

Participate now!

Tags