This is not the latest version of ROCm documentation. See ROCm documentation for the latest version.

Quick start installation guide

Quick start installation guide#

Applies to Linux

2024-10-23

7 min read time

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 a Radeon GPU with graphical applications, refer to the Radeon installation instructions.

sudo apt update
sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)"
sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
wget https://repo.radeon.com/amdgpu-install/6.2.1/ubuntu/noble/amdgpu-install_6.2.60201-1_all.deb
sudo apt install ./amdgpu-install_6.2.60201-1_all.deb
sudo apt update
sudo apt install amdgpu-dkms rocm
sudo apt update
sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)"
sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
wget https://repo.radeon.com/amdgpu-install/6.2.1/ubuntu/jammy/amdgpu-install_6.2.60201-1_all.deb
sudo apt install ./amdgpu-install_6.2.60201-1_all.deb
sudo apt update
sudo apt install amdgpu-dkms rocm

Before installing ROCm on RHEL, register your Enterprise Linux.

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 "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)"
sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
sudo dnf install https://repo.radeon.com/amdgpu-install/6.2.1/rhel/9.4/amdgpu-install-6.2.60201-1.el9.noarch.rpm
sudo dnf clean all
sudo dnf install amdgpu-dkms rocm

Before installing ROCm on RHEL, register your Enterprise Linux.

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 "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)"
sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
sudo dnf install https://repo.radeon.com/amdgpu-install/6.2.1/rhel/9.3/amdgpu-install-6.2.60201-1.el9.noarch.rpm
sudo dnf clean all
sudo dnf install amdgpu-dkms rocm

Before installing ROCm on RHEL, register your Enterprise Linux.

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 "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)"
sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
sudo dnf install https://repo.radeon.com/amdgpu-install/6.2.1/rhel/8.10/amdgpu-install-6.2.60201-1.el8.noarch.rpm
sudo dnf clean all
sudo dnf install amdgpu-dkms rocm

Before installing ROCm on RHEL, register your Enterprise Linux.

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 "kernel-headers-$(uname -r)" "kernel-devel-$(uname -r)"
sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
sudo dnf install https://repo.radeon.com/amdgpu-install/6.2.1/rhel/8.9/amdgpu-install-6.2.60201-1.el8.noarch.rpm
sudo dnf clean all
sudo dnf install amdgpu-dkms rocm

Before installing ROCm on SLES, register your Enterprise Linux.

sudo zypper update
SUSEConnect -p sle-module-desktop-applications/15.6/x86_64
SUSEConnect -p sle-module-development-tools/15.6/x86_64
SUSEConnect -p PackageHub/15.6/x86_64
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 install kernel-default-devel
sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/6.2.1/sle/15.6/amdgpu-install-6.2.60201-1.noarch.rpm
sudo zypper refresh
sudo zypper install amdgpu-dkms rocm

Before installing ROCm on SLES, register your Enterprise Linux.

sudo zypper update
SUSEConnect -p sle-module-desktop-applications/15.5/x86_64
SUSEConnect -p sle-module-development-tools/15.5/x86_64
SUSEConnect -p PackageHub/15.5/x86_64
sudo zypper addrepo https://download.opensuse.org/repositories/devel:languages:perl/15.5/devel:languages:perl.repo
sudo zypper addrepo https://download.opensuse.org/repositories/Education/15.5/Education.repo
sudo zypper install kernel-default-devel
sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
sudo zypper --no-gpg-checks install https://repo.radeon.com/amdgpu-install/6.2.1/sle/15.5/amdgpu-install-6.2.60201-1.noarch.rpm
sudo zypper refresh
sudo zypper install amdgpu-dkms rocm

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.