Quick start installation guide — ROCm installation (Linux) (original) (raw)
Quick start installation guide#
2025-03-27
10 min read time
Applies to Linux
This topic provides basic installation instructions for ROCm on Linux using your distribution’s native package manager. Before you begin, you should confirm your kernel version matches the ROCm system requirements.
Once you do, review your required installation instructions by selecting your operating system and version, and then run the provided commands in your terminal. The commands include the installation of the prerequisites, along with installing ROCm.
For more in-depth installation instructions, refer to ROCm on Linux detailed installation overview.
Note
If you’re using ROCm with AMD Radeon or Radeon Pro GPUs for graphics workloads, see the Use ROCm on Radeon GPU documentation for installation instructions .
ROCm installation#
Ubuntu
24.04
wget https://repo.radeon.com/amdgpu-install/6.4.1/ubuntu/noble/amdgpu-install_6.4.60401-1_all.deb sudo apt install ./amdgpu-install_6.4.60401-1_all.deb sudo apt update sudo apt install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo apt install rocm
22.04
wget https://repo.radeon.com/amdgpu-install/6.4.1/ubuntu/jammy/amdgpu-install_6.4.60401-1_all.deb sudo apt install ./amdgpu-install_6.4.60401-1_all.deb sudo apt update sudo apt install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo apt install rocm
Debian
12
wget https://repo.radeon.com/amdgpu-install/6.4.1/ubuntu/jammy/amdgpu-install_6.4.60401-1_all.deb sudo apt install ./amdgpu-install_6.4.60401-1_all.deb sudo apt update sudo apt install -y python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo apt install rocm
Red Hat Enterprise Linux
9.6
Before installing ROCm on RHEL, register your Enterprise Linux and update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/rhel/9.6/amdgpu-install-6.4.60401-1.el9.noarch.rpm sudo dnf clean all wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm sudo rpm -ivh epel-release-latest-9.noarch.rpm sudo dnf install dnf-plugin-config-manager sudo crb enable sudo dnf install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo dnf install rocm
9.5
Before installing ROCm on RHEL, register your Enterprise Linux and update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/rhel/9.5/amdgpu-install-6.4.60401-1.el9.noarch.rpm sudo dnf clean all wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm sudo rpm -ivh epel-release-latest-9.noarch.rpm sudo dnf install dnf-plugin-config-manager sudo crb enable sudo dnf install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo dnf install rocm
9.4
Before installing ROCm on RHEL, register your Enterprise Linux and update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/rhel/9.4/amdgpu-install-6.4.60401-1.el9.noarch.rpm sudo dnf clean all wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm sudo rpm -ivh epel-release-latest-9.noarch.rpm sudo dnf install dnf-plugin-config-manager sudo crb enable sudo dnf install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo dnf install rocm
8.10
Before installing ROCm on RHEL, register your Enterprise Linux and update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/rhel/8.10/amdgpu-install-6.4.60401-1.el8.noarch.rpm sudo dnf clean all wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm sudo rpm -ivh epel-release-latest-8.noarch.rpm sudo dnf install dnf-plugin-config-manager sudo crb enable sudo dnf install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo dnf install rocm
Oracle Linux
9
Before installing ROCm on OL, update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/el/9.5/amdgpu-install-6.4.60401-1.el9.noarch.rpm sudo dnf clean all wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm sudo rpm -ivh epel-release-latest-9.noarch.rpm sudo dnf install dnf-plugin-config-manager sudo crb enable sudo dnf install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo dnf install rocm
8
Before installing ROCm on OL, update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/el/8.10/amdgpu-install-6.4.60401-1.el8.noarch.rpm sudo dnf clean all wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm sudo rpm -ivh epel-release-latest-8.noarch.rpm sudo dnf install dnf-plugin-config-manager sudo crb enable sudo dnf install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo dnf install rocm
SUSE Linux Enterprise Server
15.6
Before installing ROCm on SLES, register your Enterprise Linux update the OS installation.
sudo SUSEConnect -p sle-module-desktop-applications/15.6/x86_64 sudo SUSEConnect -p sle-module-development-tools/15.6/x86_64 sudo SUSEConnect -p PackageHub/15.6/x86_64 sudo zypper install zypper sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/6.4.1/sle/15.6/amdgpu-install-6.4.60401-1.noarch.rpm sudo zypper --gpg-auto-import-keys refresh sudo zypper addrepo https://download.opensuse.org/repositories/devel:languages:perl/15.6/devel:languages:perl.repo sudo zypper addrepo https://download.opensuse.org/repositories/Education/15.6/Education.repo sudo zypper addrepo https://download.opensuse.org/repositories/science/SLE_15_SP5/science.repo sudo zypper --gpg-auto-import-keys refresh sudo zypper install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo zypper install rocm
Azure Linux
3.0
sudo tdnf install dnf-plugin-config-manager sudo curl -o /etc/yum.repos.d/azurelinux-extended.repo https://packages.microsoft.com/azurelinux/3.0/prod/extended/x86_64/config.repo sudo tdnf install python3-setuptools python3-wheel sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups sudo tdnf install https://repo.radeon.com/amdgpu-install/6.4.1/azurelinux/3.0/amdgpu-install-6.4.60401-1.azl3.noarch.rpm --nogpgcheck sudo tdnf clean all sudo tdnf install rocm
AMDGPU driver installation#
Ubuntu
24.04
wget https://repo.radeon.com/amdgpu-install/6.4.1/ubuntu/noble/amdgpu-install_6.4.60401-1_all.deb sudo apt install ./amdgpu-install_6.4.60401-1_all.deb sudo apt update sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" sudo apt install amdgpu-dkms
22.04
wget https://repo.radeon.com/amdgpu-install/6.4.1/ubuntu/jammy/amdgpu-install_6.4.60401-1_all.deb sudo apt install ./amdgpu-install_6.4.60401-1_all.deb sudo apt update sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" sudo apt install amdgpu-dkms
Debian
12
wget https://repo.radeon.com/amdgpu-install/6.4.1/ubuntu/jammy/amdgpu-install_6.4.60401-1_all.deb sudo apt install ./amdgpu-install_6.4.60401-1_all.deb sudo apt update sudo apt install "linux-headers-$(uname -r)" sudo apt install amdgpu-dkms
Red Hat Enterprise Linux
9.6
Before installing AMDGPU driver on RHEL, register your Enterprise Linux and update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/rhel/9.6/amdgpu-install-6.4.60401-1.el9.noarch.rpm sudo dnf clean all sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)" sudo dnf install amdgpu-dkms
9.5
Before installing AMDGPU driver on RHEL, register your Enterprise Linux and update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/rhel/9.5/amdgpu-install-6.4.60401-1.el9.noarch.rpm sudo dnf clean all sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)" sudo dnf install amdgpu-dkms
9.4
Before installing AMDGPU driver on RHEL, register your Enterprise Linux and update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/rhel/9.4/amdgpu-install-6.4.60401-1.el9.noarch.rpm sudo dnf clean all sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" "kernel-devel-matched-$(uname -r)" sudo dnf install amdgpu-dkms
8.10
Before installing AMDGPU driver on RHEL, register your Enterprise Linux and update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/rhel/8.10/amdgpu-install-6.4.60401-1.el8.noarch.rpm sudo dnf clean all sudo dnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" sudo dnf install amdgpu-dkms
Oracle Linux
9
Before installing AMDGPU driver on OL, update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/el/9.5/amdgpu-install-6.4.60401-1.el9.noarch.rpm sudo dnf clean all sudo dnf install "kernel-uek-devel-$(uname -r)" sudo dnf install amdgpu-dkms
8
Before installing AMDGPU driver on OL, update the OS installation.
sudo dnf install https://repo.radeon.com/amdgpu-install/6.4.1/el/8.10/amdgpu-install-6.4.60401-1.el8.noarch.rpm sudo dnf clean all sudo dnf install "kernel-uek-devel-$(uname -r)" sudo dnf install amdgpu-dkms
SUSE Linux Enterprise Server
15.6
Before installing AMDGPU driver on SLES, register your Enterprise Linux and update the OS installation.
sudo SUSEConnect -p sle-module-desktop-applications/15.6/x86_64 sudo SUSEConnect -p sle-module-development-tools/15.6/x86_64 sudo SUSEConnect -p PackageHub/15.6/x86_64 sudo zypper install zypper sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/6.4.1/sle/15.6/amdgpu-install-6.4.60401-1.noarch.rpm sudo zypper --gpg-auto-import-keys refresh sudo zypper install kernel-default-devel sudo zypper install amdgpu-dkms
Azure Linux
3.0
sudo tdnf install "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)" sudo tdnf install azurelinux-repos-amd sudo tdnf repolist --refresh sudo tdnf install amdgpu
Important
To apply all settings, reboot your system.
After completing the installation, review the Post-installation instructions. If you have issues with your installation, see Troubleshooting.