Skip to content

Driver Linux

Huts, Roman edited this page Mar 12, 2026 · 8 revisions

Driver Installation

Table of Contents

Driver Support Matrix

Name Code name Legacy Driver Latest driver
Radeon RX
RX 53xx Navi14
RX 55xx Navi14
RX 56xx Navi10
RX 57xx Navi10
RX 63xx Navi24
RX 64xx Navi24
RX 65xx Navi24
RX 66xx Navi23
RX 67xx Navi22
RX 68xx Navi21
RX 69xx Navi21
RX 75xx Navi33
RX 76xx Navi33
RX 77xx Navi32
RX 78xx Navi32
RX 79xx Navi31
RX 906x Navi44
RX 907x Navi48
Radeon Pro
V 520 Navi12
W 53xx Navi14
W 55xx Navi14
W 56xx Navi10
W 57xx Navi10
V 620 Navi21
W 63xx Navi24
W 64xx Navi24
W 65xx Navi24
W 66xx Navi23
W 67xx Navi22
W 68xx Navi21
V 710 Navi32
W 75xx Navi33
W 76xx Navi33
W 77xx Navi32
W 78xx Navi32
W 79xx Navi31
APU
Ryzen 5xxx Cezanne
Ryzen 6xxx Rembrandt
Ryzen 7xxx Raphael
Ryzen 8xxx Phoenix
Ryzen 9xxx Granite Ridge

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.

Differences in Linux Distribution

AMF supports the latest version of Ubuntu, currently Ubuntu 25.10 (Questing Quokka). For Ubuntu 25.10, users do not need to install the base Radeon driver below as a prerequisite for installing AMF and doing so may actually cause conflicts with Radeon Vulkan (RADV) which is already included with Ubuntu 25.10.

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 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

Install

  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

Uninstall

  1. Run the installer script with the --uninstall flag.

    sudo ./amf_installer_25.20.sh --uninstall
  2. Follow the latest instructions to uninstall the "All-Open" AMD GPU driver stack if it is no longer needed.

    Uninstalling the amdgpu stack

  3. Reboot your system.

Legacy Instructions (Driver Version < 25.20)

Legacy Install

⚠️ 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

Legacy Uninstall

  1. To uninstall AMF and the amdgpu stack, run the amdgpu-uninstall script:

    sudo amdgpu-uninstall
  2. For a complete uninstall, remove the installer package.

    # Ubuntu example:
    sudo apt-get purge amdgpu-install
  3. Reboot your system.

Clone this wiki locally