Skip to main content

Docker Hardware Acceleration - VAAPI


Unmanic supports hardware acceleration (HWA) of video decoding using FFmpeg. FFmpeg and Unmanic can support multiple hardware acceleration implementations such as nVidia NVENC and MediaCodec through Video Acceleration API's.

VAAPI is a Video Acceleration API that uses libva to interface with local drivers to provide HWA.

You can find a list of supported codecs for VAAPI here. Both Intel iGPU and AMD GPU can use VAAPI.

NOTE: AMD GPU requires open source driver Mesa 20.1 or higher to support hardware decoding HEVC.

Running Unmanic with support for VAAPI

To enable VAAPI, you will need to run Unmanic on a device that supports it.

If you intend to use Unmanic inside a Docker container, you will also need to pass through the required devices to the container.

An example of this is shown below:

  PUID=$(id -u)
PGID=$(id -g)

# CONFIG_DIR - Where you settings are saved

# LIBRARY_DIR - The location/locations of your library

# CACHE_DIR - A tmpfs or and folder for temporary conversion files

docker run -ti --rm \
-e PUID=${PUID} \
-e PGID=${PGID} \
--device=/dev/dri \
-p 8888:8888 \
-v ${CONFIG_DIR}:/config \
-v ${LIBRARY_DIR}:/library \
-v ${CACHE_DIR}:/tmp/unmanic \