Debian native installation

Debian native installation#

2025-06-24

4 min read time

Applies to Linux

Caution

Ensure that the Installation prerequisites are met before installing.

Note

The following installation steps also apply when upgrading from a previous ROCm version.

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#

# Register ROCm packages
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/rocm.gpg] https://repo.radeon.com/rocm/apt/6.4.3 jammy main" \
    | sudo tee /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
sudo apt update

Installing#

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-language-runtime

ROCm runtime environment for running applications on the AMD platform.

lrt

rocm-hip-runtime

Run HIP applications written for the AMD platform.

hip

rocm-hip-libraries

HIP libraries optimized for the AMD platform.

Legacy use case does not exist.

rocm-opencl-runtime

Run OpenCL-based applications on the AMD platform.

opencl

rocm-ml-libraries

Key machine learning libraries. Includes MIOpen.

mllib

Other packages

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

hsa-runtime-rocr4wsl-amdgpu

For users of ROCm in a Windows Subsystem for Linux (WSL) context. This package is only supported for Ubuntu.

wsl

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-opencl-sdk

Develop OpenCL-based applications for the AMD platform.

openclsdk

rocm-openmp-sdk

Develop OpenMP-based applications for the AMD software.

openmpsdk

rocm-ml-sdk

Develop and run machine learning applications for AMD.

mlsdk

Footnotes

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

# Restart the system
sudo reboot

Note

For information about the AMDGPU driver installation, see the Debian native installation in the AMD Instinct Data Center GPU Documentation.