Azure Linux native installation

Azure Linux native installation#

2025-11-26

4 min read time

Applies to Linux

Caution

Ensure that the Installation prerequisites are met.

Note

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

Registering ROCm repositories#

AZL 3.0

sudo tee /etc/yum.repos.d/rocm.repo <<EOF
[rocm]
name=ROCm 7.0.1 repository
baseurl=https://repo.radeon.com/rocm/azurelinux3/7.0.1/main/
enabled=1
gpgcheck=1
gpgkey=https://repo.radeon.com/rocm/rocm.gpg.key
EOF
sudo tdnf clean all

Installing#

Install kernel driver#

For information about the AMDGPU driver installation, see amdgpu-driver-install in the ROCm documentation.

For information about driver compatibility, see User and AMD GPU Driver (amdgpu) support matrix.

Install ROCm#

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]
`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 package
`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`

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

Important

To apply all settings, reboot your system.