Azure Linux native installation#
2025-06-24
4 min read time
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#
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
[ROCm-6.4.3]
name=ROCm6.4.3
baseurl=https://repo.radeon.com/rocm/azurelinux3/6.4.3/main/
enabled=1
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo tdnf clean all
Installing#
sudo tdnf install rocm
ROCm installation can be tailored to your requirements using one more combinations of ROCm meta packages:
To use pre-built ROCm libraries and tools, include ROCm runtime packages in the installation step.
To develop and build individual ROCm libraries and tools, include ROCm developer packages in the installation step.
ROCm runtime packages#
Meta package |
Description |
Legacy use case [1] |
---|---|---|
|
All ROCm core packages, tools, and libraries. |
|
|
ROCm runtime environment for running applications on the AMD platform. |
|
|
Run HIP applications written for the AMD platform. |
|
|
HIP libraries optimized for the AMD platform. |
Legacy use case does not exist. |
|
Run OpenCL-based applications on the AMD platform. |
|
|
Key machine learning libraries. Includes MIOpen. |
|
Other packages |
||
|
For users of graphics applications which require the open source Mesa 3D graphics and multimedia libraries. This package is primarily used for Radeon GPUs. |
|
|
For users of ROCm in a Windows Subsystem for Linux (WSL) context. This package is only supported for Ubuntu. |
|
ROCm developer packages#
Meta package |
Description |
Legacy use case [1] |
---|---|---|
|
Debug and profile HIP applications. |
|
|
Develop applications on HIP or port from CUDA. |
Legacy use case does not exist. |
|
Develop or port HIP applications and libraries for the AMD platform. |
|
|
Develop OpenCL-based applications for the AMD platform. |
|
|
Develop OpenMP-based applications for the AMD software. |
|
|
Develop and run machine learning applications for AMD. |
|
Footnotes
Post-installation#
Complete the Post-installation instructions.
Uninstalling#
Uninstall ROCm meta packages#
sudo tdnf remove rocm
sudo tdnf remove rocm-core
Remove ROCm repositories#
# Remove the repositories
sudo rm /etc/yum.repos.d/rocm.repo*
# Clear the cache and clean the system
sudo rm -rf /var/cache/tdnf
sudo tdnf clean all
# Restart the system
sudo reboot
Note
For information about the AMDGPU driver installation, see the Azure Linux native installation in the AMD Instinct Data Center GPU Documentation.