Skip to content

Driver Linux

Jump to bottom
Huts, Roman edited this page Oct 29, 2025 · 5 revisions

Driver Installation

Table of Contents

Instructions

Starting with Linux driver version 25.20, AMF is installed separately from the AMD GPU driver by using the amf_installer_<DRIVER VERSION>.sh script.

Prerequisites

The "All-Open" stack of the AMD GPU driver needs to be installed as a prerequisite for the new AMF installer script. The "All-Open" stack uses the Radeon Vulkan (RADV) open-sourced Vulkan driver, integrated into the Mesa 3D graphics library. ROCr (ROCm Runtime for OpenCL) can be optionally installed as part of the stack.

The instructions for the AMD GPU driver setup can be found here: https://amdgpu-install.readthedocs.io/en/latest/

  1. Example command with default options to install the DKMS kernel driver and Mesa graphics stack (OpenGL, Radeon Vulkan (RADV), and multimedia).

    sudo amdgpu-install -y

  2. Or with additionally installing the optional ROCr for OpenCL.

    sudo amdgpu-install -y --opencl=rocr

AMF Installer

  1. Download the .zip file containing the AMF installer script from the downloadble assets belonging to the latest AMF release version.

    wget https://github.com/GPUOpen-LibrariesAndSDKs/AMF/releases/download/<AMF RELEASE VERSION>/amf_installer_<DRIVER VERSION>.zip

# for example, AMF v1.5.0 for the 25.20 AMD GPU driver:
wget https://github.com/GPUOpen-LibrariesAndSDKs/AMF/releases/download/v1.5.0/amf_installer_25.20.zip

  2. Extract the downloaded .zip file.

    unzip amf_installer_25.20.zip

  3. Run the installer with sudo and then either accept the EULA when prompted or non-interactively by using the --accept-eula option.

    sudo ./amf_installer_25.20.sh

    or

    sudo ./amf_installer_25.20.sh --accept-eula

Legacy Instructions (Driver Version < 25.20)

⚠️ Note : There is currently a bug in the installer (25.10 driver) where AMF is not installed unless the EULA is accepted during installation.

  • Please add the following option while running the amdgpu-install script :

    --accept-eula

  • The AMF component can be installed through the amdgpu-install script with the workstation ("Pro Variant") or graphics ("All-Open Variant") stack use case:

    sudo amdgpu-install -y --usecase=workstation,amf

# or

sudo amdgpu-install -y --usecase=graphics,amf

  • To install just AMF:

    sudo amdgpu-install -y --usecase=amf

  • The OpenCL component is optional and can be installed with the --opencl option:

    Option Description
    --opencl=rocr Installs ROCr OpenCL
    --opencl=legacy Installs legacy OpenCL (DEPRECATED Proprietary)
    --opencl=rocr,legacy Installs both ROCr and legacy OpenCL

    Note:

    OpenCL is optional and parts of AMF that use Vulkan will work without OpenCL.

    • ROCr: Provides support for Vega 10 and newer hardware.
    • Legacy: Provides support for hardware older than Vega 10.

  • The Vulkan component is optional and can be installed with the --vulkan option:

    Option Description
    --vulkan=amdvlk Installs open source Vulkan
    --vulkan=pro Installs PRO Vulkan (Proprietary)
    --vulkan=amdvlk,pro Installs both open and PRO Vulkan

  • Reboot after installing

Clone this wiki locally