6.2 KiB
Quick Start (Linux)
Install Prerequisites
The driver package uses
{abbr}DKMS (Dynamic Kernel Module Support) 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
sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)"
:::
:::{tab-item} Red Hat Enterprise Linux :sync: RHEL
sudo yum install kernel-headers kernel-devel
:::
:::{tab-item} SUSE Linux Enterprise Server 15 :sync: SLES15
sudo zypper install kernel-default-devel
::: ::::
Add Repositories
::::::{tab-set} :::::{tab-item} Ubuntu :sync: ubuntu
::::{rubric} 1. Download and convert the package signing key ::::
# Make the directory if it doesn't exist yet.
# This location is recommended by the distribution maintainers.
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
# Download the key, convert the signing-key to a full
# keyring required by apt and store in the keyring directory
wget https://repo.radeon.com/rocm/rocm.gpg.key -O - | \
gpg --dearmor | sudo tee /etc/apt/keyrings/rocm.gpg > /dev/null
::::{rubric} 2. Add the repositories ::::
::::{tab-set} :::{tab-item} Ubuntu 20.04 :sync: ubuntu-20.04
# Kernel driver repository for focal
sudo tee /etc/apt/sources.list.d/amdgpu.list <<'EOF'
deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/latest/ubuntu focal main
EOF
# ROCm repository for focal
sudo tee /etc/apt/sources.list.d/rocm.list <<'EOF'
deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/debian focal main
EOF
::: :::{tab-item} Ubuntu 22.04 :sync: ubuntu-22.04
# Kernel driver repository for jammy
sudo tee /etc/apt/sources.list.d/amdgpu.list <<'EOF'
deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/latest/ubuntu jammy main
EOF
# ROCm repository for jammy
sudo tee /etc/apt/sources.list.d/rocm.list <<'EOF'
deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/debian jammy main
EOF
::: ::::
::::{rubric} 3. Update the list of packages ::::
sudo apt update
:::::
:::::{tab-item} Red Hat Enterprise Linux :sync: RHEL
::::{rubric} 1. Add the repositories ::::
::::{tab-set} :::{tab-item} RHEL 8.6 :sync: RHEL-8.6
# Add the amdgpu module repository for RHEL 8.6
sudo tee /etc/yum.repos.d/amdgpu.repo <<'EOF'
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/latest/rhel/8.6/main/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
# Add the rocm repository for RHEL 8
sudo tee /etc/yum.repos.d/rocm.repo <<'EOF'
[rocm]
name=rocm
baseurl=https://repo.radeon.com/rocm/rhel8/latest/main
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
:::
:::{tab-item} RHEL 8.7 :sync: RHEL-8.7
# Add the amdgpu module repository for RHEL 8.7
sudo tee /etc/yum.repos.d/amdgpu.repo <<'EOF'
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/latest/rhel/8.7/main/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
# Add the rocm repository for RHEL 8
sudo tee /etc/yum.repos.d/rocm.repo <<'EOF'
[rocm]
name=rocm
baseurl=https://repo.radeon.com/rocm/rhel8/latest/main
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
:::
:::{tab-item} RHEL 9.1 :sync: RHEL-9.1
# Add the amdgpu module repository for RHEL 9.1
sudo tee /etc/yum.repos.d/amdgpu.repo <<'EOF'
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/latest/rhel/9.1/main/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
# Add the rocm repository for RHEL 9
sudo tee /etc/yum.repos.d/rocm.repo <<'EOF'
[rocm]
name=rocm
baseurl=https://repo.radeon.com/rocm/rhel9/latest/main
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
::: ::::
::::{rubric} 2. Clean cached files from enabled repositories ::::
sudo yum clean all
:::::
:::::{tab-item} SUSE Linux Enterprise Server 15 :sync: SLES15
::::{rubric} 1. Add the repositories ::::
::::{tab-set} :::{tab-item} Service Pack 4 :sync: SLES15-SP4
# Add the amdgpu module repository for SLES 15.4
sudo tee /etc/zypp/repos.d/amdgpu.repo <<'EOF'
[amdgpu]
name=amdgpu
baseurl=https://repo.radeon.com/amdgpu/latest/sle/15.4/main/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
# Add the rocm repository for SLES
sudo tee /etc/zypp/repos.d/rocm.repo <<'EOF'
[rocm]
name=rocm
baseurl=https://repo.radeon.com/rocm/zyp/zypper
enabled=1
priority=50
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
::: ::::
::::{rubric} 2. Update the new repository ::::
sudo zypper ref
::::: ::::::
Install Drivers
Install the amdgpu-dkms kernel module, aka driver, on your system.
::::{tab-set}
:::{tab-item} Ubuntu :sync: ubuntu
sudo apt install amdgpu-dkms
:::
:::{tab-item} Red Hat Enterprise Linux :sync: RHEL
sudo yum install amdgpu-dkms
:::
:::{tab-item} SUSE Linux Enterprise Server 15 :sync: SLES15
sudo zypper install amdgpu-dkms
:::
::::
Install ROCm Runtimes
Install the rocm-hip-libraries meta-package. This contains dependencies for most
common ROCm applications.
::::{tab-set} :::{tab-item} Ubuntu :sync: ubuntu
sudo apt install rocm-hip-libraries
:::
:::{tab-item} Red Hat Enterprise Linux :sync: RHEL
sudo yum install rocm-hip-libraries
:::
:::{tab-item} SUSE Linux Enterprise Server 15 :sync: SLES15
sudo zypper install rocm-hip-libraries
::: ::::
Reboot the system
Loading the new driver requires a reboot of the system.
sudo reboot