Install Package Manager

Install Package Manager#

Caution
Ensure that the Installation prerequisites are met before installing.

Note
The following installation steps also apply when upgrading from a previous ROCm version.
Package Manager install is an advanced installation method that provides the user with extra flexibility and robustness.

Registering ROCm 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.

Register packages#

Ubuntu 24.04

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/7.1/ noble main
EOF
sudo tee /etc/apt/preferences.d/rocm-pin-600 << EOF
Package: *
Pin: release o=repo.radeon.com
Pin-Priority: 600
EOF
sudo apt update

Installation#

Prepare the system#

For ROCm on Ryzen, it is required to operate on the 6.14 OEM kernel.

  1. To install the kernel, run the following command:

    sudo apt update && sudo apt-get install linux-oem-24.04c

  2. Once installation is complete, reboot your system and boot into the 6.14 OEM kernel:

    uname -r

    Note
    This returns a 6.14.0 based string.

  3. Ensure that the system is up to date:

    sudo apt upgrade -y

Install ROCm#

sudo apt install rocm

ROCm installation can be tailored to your requirements using one more combinations of ROCm meta packages:

ROCm runtime packages#

Meta package

Description

Legacy use case 1

rocm

All ROCm core packages, tools, and libraries.

rocm

rocm-hip-libraries

HIP libraries optimized for the AMD platform.

Legacy use case does not exist.

rocm-hip-runtime

Run HIP applications written for the AMD platform.

hip

rocm-language-runtime

ROCm runtime environment for running applications on the AMD platform.

lrt

rocm-ml-libraries

Key machine learning libraries. Includes MIOpen.

mllib

rocm-opencl-runtime

Run OpenCL-based applications on the AMD platform.

opencl

Other packages#

Package

Description

Legacy use case 1

amdgpu-lib

For users of graphics applications which require the open source Mesa 3D graphics and multimedia libraries. This package is primarily used for Radeon GPUs.

graphics

ROCm developer packages#

Meta package

Description

Legacy use case 1

rocm-developer-tools

Debug and profile HIP applications.

rocmdevtools

rocm-hip-runtime-devel

Develop applications on HIP or port from CUDA.

Legacy use case does not exist.

rocm-hip-sdk

Develop or port HIP applications and libraries for the AMD platform.

hiplibsdk

rocm-ml-sdk

Develop and run machine learning applications for AMD.

mlsdk

rocm-opencl-sdk

Develop OpenCL-based applications for the AMD platform.

openclsdk

rocm-openmp-sdk

Develop OpenMP-based applications for the AMD software.

openmpsdk

Footnote#

[1] (1,2)
Starting from ROCm 6.4.2, “Legacy use cases” in amdgpu-install are replaced by the equivalent meta package. In addition, the following amdgpu-install use cases: asan, rocmdev, multimedia, multimediasdk, amf, and workstation are deprecated.

Post-installation#

Complete the Post-installation instructions.

Uninstalling#

Uninstall ROCm meta packages#

sudo apt autoremove rocm
sudo apt autoremove rocm-core

Remove ROCm repositories#

# Remove the repositories
sudo rm /etc/apt/sources.list.d/rocm.list
# Clear the cache and clean the system
sudo rm -rf /var/cache/apt/*
sudo apt clean all
sudo apt update

Important
To apply all settings, reboot your system.

Contents