Skip to content

Hardware Transcoding

linux-universe edited this page Aug 9, 2025 · 4 revisions

Hardware Transcoding

Note

This guide is based on the quadlet files in main.

VAAPI (AMD / NVIDIA / Intel) & Quick Sync (Intel)

To enable VAAPI or Quick Sync hardware transcoding, uncomment the following line in immich-server.container:

AddDevice=/dev/dri

In the Admin page under Video transcoding settings, change the hardware acceleration setting to the appropriate option and save.

NVENC (NVIDIA)

Warning

As I don't have the necessary hardware, I couldn't test the Nvidia instruction. Any confirmation would be appreciated.

Uncomment and add the following lines in immich-server.container:

AddDevice=/dev/dri
# Make sure this matches your GPU ID
AddDevice=nvidia.com/gpu=0
Unmask=/dev/dri:/dev/dri

In the Admin page under Video transcoding settings, change the hardware acceleration setting to the appropriate option and save.

Clone this wiki locally