.. meta:: :description: Installation prerequisites :keywords: installation prerequisites, AMD, AMDGPU, driver ********************************************************************* Installation prerequisites ********************************************************************* Before installing the driver, complete the following prerequisites. 1. Confirm the system has a supported Linux version. * To obtain the Linux distribution information, use the following command: .. code-block:: shell uname -m && cat /etc/*release * Confirm that your Linux distribution matches a `supported distribution `_. **Example:** Running the preceding command on an Ubuntu system produces the following output: .. code-block:: shell x86_64 DISTRIB_ID=Ubuntu DISTRIB_RELEASE=26.04 DISTRIB_CODENAME=resolute DISTRIB_DESCRIPTION="Ubuntu 26.04 LTS" PRETTY_NAME="Ubuntu 26.04 LTS" NAME="Ubuntu" VERSION_ID="26.04" VERSION="26.04 (Resolute Raccoon)" VERSION_CODENAME=resolute ID=ubuntu ID_LIKE=debian HOME_URL="https://www.ubuntu.com/" SUPPORT_URL="https://help.ubuntu.com/" BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/" PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy" UBUNTU_CODENAME=resolute LOGO=ubuntu-logo .. _verify_kernel_version: 2. Verify the kernel version. * To check the kernel version of your Linux system, type the following command: .. code-block:: shell uname -srmv **Example:** The preceding command lists the kernel version in the following format: .. code-block:: shell Linux 7.0.0-15-generic #15-Ubuntu SMP PREEMPT_DYNAMIC Wed Apr 22 16:06:43 UTC 2026 x86_64 * Confirm that your kernel version matches the system requirements, as listed in `Operating system support `_ .. _register-enterprise-linux: Register your Enterprise Linux ========================================================== If you're using Red Hat Enterprise Linux (RHEL) or SUSE Linux Enterprise Server (SLES), register your operating system to ensure you're able to download and install packages. .. datatemplate:nodata:: .. tab-set:: .. tab-item:: Ubuntu :sync: ubuntu-tab There is no registration required for Ubuntu. .. tab-item:: Debian :sync: debian-tab There is no registration required for Debian. .. tab-item:: Red Hat Enterprise Linux :sync: rhel-tab .. tab-set:: {% for os_version in config.html_context['rhel_version_numbers'] %} {% set os_major, _ = os_version.split('.') %} .. tab-item:: {{ os_version }} :sync: {{ os_version }} Typically you can register by following the step-by-step user interface. If you need to register by command line, use the following commands: .. code-block:: shell :substitutions: {% if os_major == '10' -%} subscription-manager register --username --password {%- else -%} subscription-manager register --username --password subscription-manager attach --auto {%- endif %} More details about `registering for RHEL `_ {% endfor %} .. tab-item:: Oracle Linux :sync: ol-tab There is no registration required for Oracle Linux. .. tab-item:: SUSE Linux Enterprise Server :sync: sle-tab Typically you can register by following the step-by-step user interface. If you need to register by command line, use the following commands: .. code-block:: shell sudo SUSEConnect -r More details about `registering for SLES `_ .. tab-item:: Rocky Linux :sync: rl-tab There is no registration required for Rocky Linux. .. _update-enterprise-linux: Update your Enterprise Linux ========================================================== If you are using Red Hat Enterprise Linux (RHEL) or SUSE Linux Enterprise Servers (SLES), or Oracle Linux (OL), or Rocky Linux, it is recommended that you update your operating system to the latest packages from the Linux distribution. This is a requirement for newer hardware on older versions of RHEL, SLES, OL, or Rocky Linux. .. datatemplate:nodata:: .. tab-set:: .. tab-item:: Ubuntu :sync: ubuntu-tab There is no update required for Ubuntu. .. tab-item:: Debian :sync: debian-tab There is no update required for Debian. .. tab-item:: Red Hat Enterprise Linux :sync: rhel-tab .. tab-set:: {% for os_version in config.html_context['rhel_version_numbers'] %} {% set os_major, _ = os_version.split('.') %} .. tab-item:: {{ os_version }} :sync: {{ os_version }} .. code-block:: bash :substitutions: {% if os_version == '10.2' -%} sudo dnf update redhat-release sudo dnf update --releasever={{ os_version }} --exclude=\*release\* {%- else -%} sudo dnf update --releasever={{ os_version }} --exclude=\*release\* {%- endif %} {% endfor %} .. tab-item:: Oracle Linux :sync: ol-tab .. tab-set:: {% for os_version in config.html_context['ol_version_numbers'] %} {% set os_major, _ = os_version.split('.') %} .. tab-item:: {{ os_version }} :sync: {{ os_version }} .. code-block:: bash :substitutions: sudo dnf update --releasever={{ os_version }} --exclude=\*release\* {% endfor %} .. tab-item:: SUSE Linux Enterprise Server :sync: sle-tab .. tab-set:: {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} .. code-block:: bash sudo zypper update {% endfor %} .. tab-item:: Rocky Linux :sync: rl-tab There is no update required for Rocky Linux. .. important:: To apply all settings, reboot your system. Kernel headers ================================================================ The driver package uses `Dynamic Kernel Module Support (DKMS) `_ to build the `amdgpu-dkms` module (driver) for the installed kernels. This requires the Linux kernel headers and modules to be installed for each. Usually these are automatically installed with the kernel, but if you have multiple kernel versions or you have downloaded the kernel images and not the kernel meta-packages then they must be manually installed. To install for the currently active kernel run the command corresponding to your distribution. .. tab-set:: .. tab-item:: Ubuntu :sync: ubuntu-tab .. datatemplate:nodata:: .. tab-set:: {% for (os_version, os_release) in config.html_context['ubuntu_version_numbers'] %} .. tab-item:: {{ os_version }} :sync: {{ os_version }} .. code-block:: shell {% if os_version == '26.04' -%} sudo apt install "linux-headers-$(uname -r)" {%- else -%} sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" {%- endif %} {% endfor %} .. tab-item:: Debian :sync: debian-tab .. code-block:: shell sudo apt install "linux-headers-$(uname -r)" .. tab-item:: Red Hat Enterprise Linux :sync: rhel-tab .. datatemplate:nodata:: .. tab-set:: {% for os_version in config.html_context['rhel_version_numbers'] %} {% set os_major, _ = os_version.split('.') %} .. tab-item:: {{ os_version }} :sync: {{ os_version }} .. code-block:: shell {% if os_major == '8' -%} sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" {%- else -%} sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)" {%- endif %} {% endfor %} .. tab-item:: Oracle Linux :sync: ol-tab .. datatemplate:nodata:: .. tab-set:: {% for os_version in config.html_context['ol_version_numbers'] %} .. tab-item:: {{ os_version }} :sync: {{ os_version }} .. code-block:: shell sudo dnf install "kernel-uek-devel-$(uname -r)" {% endfor %} .. tab-item:: SUSE Linux Enterprise Server :sync: sle-tab .. datatemplate:nodata:: .. tab-set:: {% for os_version in config.html_context['sles_version_numbers'] %} .. tab-item:: {{ os_version }} .. code-block:: shell sudo zypper install kernel-default-devel {% endfor %} .. tab-item:: Rocky Linux :sync: rl-tab .. datatemplate:nodata:: .. tab-set:: {% for os_version in config.html_context['rl_version_numbers'] %} {% set os_major, _ = os_version.split('.') %} .. tab-item:: {{ os_version }} :sync: {{ os_version }} .. code-block:: shell sudo dnf install "kernel-headers" "kernel-devel" "kernel-devel-matched" {% endfor %}