Ubuntu native installation#

Applies to Linux

2024-01-11

5 min read time

Registering repositories#

Package signing key#

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

Note

The GPG key may change; ensure it is updated when installing a new release. If the key signature verification fails while updating, re-add the key from the ROCm to the apt repository as mentioned above. The current rocm.gpg.key is not available in a standard key ring distribution but has the following SHA1 sum hash: 73f5d8100de6048aa38a8b84cd9a87f05177d208 rocm.gpg.key

Register kernel-mode driver#

Add the AMDGPU repository for the driver.

Ubuntu 22.04

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/6.0/ubuntu jammy main" \
    | sudo tee /etc/apt/sources.list.d/amdgpu.list
sudo apt update

Ubuntu 20.04

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/amdgpu/6.0/ubuntu focal main" \
    | sudo tee /etc/apt/sources.list.d/amdgpu.list
sudo apt update

Register ROCm packages#

Add the ROCm repository.

Ubuntu 22.04

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/6.0 jammy main" \
    | sudo tee --append /etc/apt/sources.list.d/rocm.list
echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \
    | sudo tee /etc/apt/preferences.d/rocm-pin-600

Ubuntu 20.04

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/6.0 focal main" \
    | sudo tee --append /etc/apt/sources.list.d/rocm.list
echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \
    | sudo tee /etc/apt/preferences.d/rocm-pin-600

Installing#

Install kernel driver#

sudo apt install amdgpu-dkms
sudo reboot

Install ROCm packages#

sudo apt install rocm-hip-sdk

Complete the Post-installation instructions.

Upgrading#

To upgrade an existing ROCm installation to a newer version, follow the steps in Registering repositories and Installing. After upgrading the kernel driver, it may also upgrade the GPU firmware which requires a system reboot to take effect.

Uninstalling#

Uninstall specific meta packages#

# sudo apt autoremove <package-name>
# For example:
sudo apt autoremove rocm-hip-sdk
# Or for version specific packages:
sudo apt autoremove rocm-hip-sdk6.0

Uninstall ROCm packages#

sudo apt autoremove rocm-core
# Or for version specific packages:
sudo apt autoremove rocm-core6.0

Uninstall kernel-mode driver#

sudo apt autoremove amdgpu-dkms

Remove ROCm and AMDGPU repositories#

# Remove the repositories.
sudo rm /etc/apt/sources.list.d/rocm.list
sudo rm /etc/apt/sources.list.d/amdgpu.list

# Clear the cache and clean the system.
sudo rm -rf /var/cache/apt/*
sudo apt-get clean all

# Restart the system.
sudo reboot