Quick start installation guide#
2024-07-23
7 min read time
This topic provides basic installation instructions for ROCm on Linux using your distribution’s native package manager. Review your required installation instructions by selecting your operating system and version, and then run the provided commands in your terminal.
For more in-depth installation instructions, refer to ROCm 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.1.2/ubuntu/jammy/amdgpu-install_6.1.60102-1_all.deb
sudo apt install ./amdgpu-install_6.1.60102-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.1.2/ubuntu/focal/amdgpu-install_6.1.60102-1_all.deb
sudo apt install ./amdgpu-install_6.1.60102-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 yum 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 yum install https://repo.radeon.com/amdgpu-install/6.1.2/rhel/9.4/amdgpu-install-6.1.60102-1.el9.noarch.rpm
sudo yum clean all
sudo yum install amdgpu-dkms rocm
Note
RHEL 9.4 is supported only on AMD Instinct MI300A.
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 yum 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 yum install https://repo.radeon.com/amdgpu-install/6.1.2/rhel/9.3/amdgpu-install-6.1.60102-1.el9.noarch.rpm
sudo yum clean all
sudo yum 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 yum 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 yum install https://repo.radeon.com/amdgpu-install/6.1.2/rhel/9.2/amdgpu-install-6.1.60102-1.el9.noarch.rpm
sudo yum clean all
sudo yum 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 yum 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 yum install https://repo.radeon.com/amdgpu-install/6.1.2/rhel/8.9/amdgpu-install-6.1.60102-1.el8.noarch.rpm
sudo yum clean all
sudo yum 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 yum 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 yum install https://repo.radeon.com/amdgpu-install/6.1.2/rhel/8.8/amdgpu-install-6.1.60102-1.el8.noarch.rpm
sudo yum clean all
sudo yum install amdgpu-dkms rocm
Before installing ROCm on SLES, register your Enterprise Linux.
sudo zypper addrepo https://download.opensuse.org/repositories/devel:languages:perl/15.5/devel:languages:perl.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.1.2/sle/15.5/amdgpu-install-6.1.60102-1.noarch.rpm
sudo zypper refresh
sudo zypper install amdgpu-dkms rocm
Before installing ROCm on SLES, register your Enterprise Linux.
# Installing Perl module from SLES 15.5, as it was removed from 15.4
sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/perl/15.5/devel:languages:perl.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.1.2/sle/15.4/amdgpu-install-6.1.60102-1.noarch.rpm
sudo zypper refresh
sudo zypper install amdgpu-dkms rocm
Note
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.