Include VAAPI drivers in Docker image

Author: tces1

README.md

@@ -41,7 +41,7 @@ Edit `docker/config/config.local.json` before starting:
 - set `server.public_url` if clients reach the proxy through another reverse proxy
 - leave `server.debug` as `false` for concise logs, or set it to `true` for detailed diagnostics
 - set `transcode.hardware_decode` to `vaapi` on Linux hosts with Intel or AMD `/dev/dri` hardware decode support
-- startup will probe VAAPI availability and fall back to software decode if the device or ffmpeg support is missing
+- startup will probe VAAPI availability, including device initialization, and fall back to software decode if the device, driver, or ffmpeg support is missing
 
 Update `docker/docker-compose.yml` to mount the local config file if you use `config.local.json`:
 
@@ -102,7 +102,7 @@ Copy `config.example.json` and change the upstream URL:
 Leave `public_url` empty when clients connect directly to EmbyTranscoder. Set it when EmbyTranscoder sits behind another reverse proxy.
 Leave `debug` as `false` for concise action-level logs. Set it to `true` when you want detailed `TRACE_SWITCH` and request-level diagnostics.
 Set `hardware_decode` to `vaapi` to enable VAAPI hardware decode. The default `hardware_device` is `/dev/dri/renderD128`.
-If the device or ffmpeg probe fails, startup falls back to software decode and logs the reason.
+If the device, driver, or ffmpeg probe fails, startup falls back to software decode and logs the reason.
 
 ## Transcode Lifecycle
 

docker/Dockerfile

@@ -11,7 +11,12 @@ RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o /out/emby-transcoder ./cmd
 FROM public.ecr.aws/docker/library/debian:bookworm-slim
 
 RUN apt-get update \
-	&& apt-get install -y --no-install-recommends ca-certificates ffmpeg \
+	&& apt-get install -y --no-install-recommends \
+		ca-certificates \
+		ffmpeg \
+		intel-media-va-driver \
+		mesa-va-drivers \
+		vainfo \
 	&& rm -rf /var/lib/apt/lists/*
 
 WORKDIR /app

docker/README.md

@@ -24,7 +24,8 @@ Edit `config/config.json` before startup, or copy it to `config/config.local.jso
 - set `server.public_url` if clients reach the proxy through another reverse proxy
 - set `server.debug` to `true` when you need detailed diagnostics
 - set `transcode.hardware_decode` to `vaapi` to use Intel or AMD VAAPI hardware decode through `/dev/dri`
-- startup probes VAAPI support and falls back to software decode when the device is unavailable or ffmpeg lacks VAAPI
+- startup probes VAAPI support, including device initialization, and falls back to software decode when the device, driver, or ffmpeg support is unavailable
+- the image includes common Intel and AMD VAAPI userspace drivers plus `vainfo`
 
 For GitHub Actions publishing to Docker Hub, set `DOCKERHUB_USERNAME` and `DOCKERHUB_TOKEN` in the repository secrets.