rocDecode environment variables

2026-10-23

1 min read time

Applies to Linux and Windows

The following environment variables affect the rocDecode runtime.

Environment variable	Values
ROCDEC_LOG_LEVEL	Sets the maximum severity of log messages during decoding. The log level defines the maximum severity of log messages to output. 0: Output critical messages only (default) 1: Output critical and error messages 2: Output critical, error and warning messages 3: Output critical, error, warning and info messages 4: Output critical, error, warning, info and debug messages
ROCR_VISIBLE_DEVICES	Takes a comma-separated list of GPU indices. When set, the decoder parses this list before it falls back to HIP_VISIBLE_DEVICES.
HIP_VISIBLE_DEVICES	Comma-separated list of GPU indices. Parsed when ROCR_VISIBLE_DEVICES isn’t set.
LIBVA_DRIVERS_PATH	Optional. Path to the directory containing the VA-API driver. Only required if the driver you want to use is neither the one that ships with ROCm nor the distribution-provided one. ROCm’s libva finds its driver under ROCM_PATH on its own: %ROCM_PATH%\lib\rocm_sysdeps\bin on Windows, $ROCM_PATH/lib/rocm_sysdeps/lib on Linux. This replaces libva’s default search directory rather than adding to it, so an incorrect value makes VA-API initialization fail.