AMD

AMD uses VAAPI on Linux and AMF on Windows. Set Settings → Hardware → Preferred Vendor to amd if you want to pin it instead of using auto detection.

AMD AV1 remains driver- and FFmpeg-stack-dependent and is not part of the validated 0.3.0 support matrix. HEVC and H.264 are the recommended AMD paths for 0.3.0.

Supported hardware

Codec	Support
H.264	Polaris+
HEVC	Polaris+
AV1	RDNA 3+ on compatible driver/FFmpeg stacks; available but not part of the validated 0.3.0 support matrix. RDNA 2 decodes AV1 but has no AV1 encoder

Linux

Host setup

Install the Mesa VAAPI drivers and verification tool:

sudo apt install mesa-va-drivers vainfo

Verify the render node on the host:

vainfo --display drm --device /dev/dri/renderD128

Docker

Pass /dev/dri into the container. The default (root) container needs no group_add. Auto-detection usually selects radeonsi; set LIBVA_DRIVER_NAME=radeonsi only if it doesn't. Running with PUID/PGID? Also add the host's numeric render GID — see Device permissions.

services:
  alchemist:
    image: ghcr.io/bybrooklyn/alchemist:latest
    ports:
      - "3000:3000"
    volumes:
      - ./config:/app/config
      - ./data:/app/data
      - /path/to/media:/media
    devices:
      - /dev/dri:/dev/dri
    environment:
      - ALCHEMIST_CONFIG_PATH=/app/config/config.toml
      - ALCHEMIST_DB_PATH=/app/data/alchemist.db
      # Optional — only if auto-detection picks the wrong driver:
      # - LIBVA_DRIVER_NAME=radeonsi
    restart: unless-stopped

docker run equivalent:

docker run -d \
  --name alchemist \
  --device /dev/dri:/dev/dri \
  -p 3000:3000 \
  -v ./config:/app/config \
  -v ./data:/app/data \
  -v /path/to/media:/media \
  -e ALCHEMIST_CONFIG_PATH=/app/config/config.toml \
  -e ALCHEMIST_DB_PATH=/app/data/alchemist.db \
  --restart unless-stopped \
  ghcr.io/bybrooklyn/alchemist:latest

Verify

vainfo --display drm --device /dev/dri/renderD128
ffmpeg -hide_banner -encoders | grep vaapi

Windows

Windows AMD support uses AMF. No device passthrough is required. Install current AMD graphics drivers and confirm FFmpeg exposes the AMF encoders:

ffmpeg -encoders | findstr amf

If NVIDIA and Intel are absent, Alchemist uses AMF automatically when AMF probing succeeds.

In Alchemist

Set Settings → Hardware → Preferred Vendor → amd. On Linux, only set Device Path if you need to force a specific render node.