Install AMD ROCm 7.12.0#
Use the following selector to choose your installation method for your supported AMD GPU or APU and operating system. For system requirements and support information, see the Compatibility matrix. To learn more about changes introduced in ROCm 7.12.0, see the Release notes.
Note
If your GPU is not listed, it might be community-enabled through TheRock nightly builds. This enablement is not part of the official ROCm release. For more information, see TheRock supported GPUs. For installation guidance, see TheRock releases.
The ROCm Runfile Installer can install ROCm and/or the AMD GPU Driver (amdgpu) without using a native Linux package management system, making it ideal for systems with policy constraints or restricted environments. Network access is not needed for install as long as dependencies for ROCm and/or AMD GPU driver (amdgpu) are met. A single installer supports all GFX architectures, automates post-installation configuration, and offers an interactive command-line GUI for guided setup.
Prerequisites#
Before installing the ROCm Core SDK 7.12.0, ensure your system meets all prerequisites. This includes installing the required dependencies and configuring permissions for GPU access. To confirm that your system is supported, see the Compatibility matrix.
Before installing the ROCm Core SDK 7.12.0, ensure your system meets all prerequisites. To confirm that your system is supported, see the Compatibility matrix.
Install essential packages for Docker containers
Docker images often include only a minimal set of installations, so some essential packages might be missing. When installing ROCm within a Docker container, you might need to install additional packages for a successful installation.
If applicable, run the following command to install essential packages:
apt update
apt install sudo wget
apt update
apt install sudo cmake libgfortran5
apt update
apt install sudo wget python3
dnf install sudo wget
zypper install sudo wget SUSEConnect
zypper install sudo wget cmake libgfortran5
zypper install sudo wget
Remove any existing HIP SDK for Windows installations and other conflicting AMD graphics software. To uninstall the HIP SDK using the GUI, navigate to the following screen:
Control Panel > Programs > Uninstall a program
Install AMD Software: Adrenalin Edition for Windows. For details and the download link, see AMD Software: Adrenalin Edition 26.3.1.
Disable the following Windows security features as they can interfere with ROCm functionality:
Turn off WDAG (Windows Defender Application Guard)
Control Panel > Programs > Programs and Features > Turn Windows features on or off > Clear “Microsoft Defender Application Guard”
Turn off SAC (Smart App Control)
Settings > Privacy & security > Windows Security > App & browser control > Smart App Control settings > Off
Install the OEM kernel#
Ryzen APUs require the OEM kernel 6.14 for Ubuntu 24.04. Use the
following command to install it using apt.
sudo apt update && sudo apt install linux-image-6.14.0-1018-oem
Note
Reboot your system after installing the OEM kernel.
Register your Red Hat Enterprise Linux system#
Register your Red Hat Enterprise Linux (RHEL) system to enable access to Red Hat repositories and ensure you’re able to download and install packages.
Run the following command to register your system:
subscription-manager register --username <username> --password <password>
subscription-manager register --username <username> --password <password>
subscription-manager attach --auto
Register your SUSE Linux Enterprise Server system#
Register your SUSE Linux Enterprise Server (SLES) system to enable access to SUSE repositories and ensure you’re able to download and install packages.
Run the following command to register your system:
sudo SUSEConnect -r <REGCODE>
Update your system#
After registering your system, update RHEL to the latest packages. This is particularly important for newer hardware on older versions of RHEL.
Run the following command to update your system:
sudo dnf update --releasever=10.1 --exclude=\*release\*
sudo dnf update --releasever=10.0 --exclude=\*release\*
sudo dnf update --releasever=9.7 --exclude=\*release\*
sudo dnf update --releasever=9.6 --exclude=\*release\*
sudo dnf update --releasever=9.4 --exclude=\*release\*
sudo dnf update --releasever=8.10 --exclude=\*release\*
Update your system#
After registering your system, update SLES to the latest available packages. This is particularly important for newer hardware on older versions of SLES.
Run the following command to update your system:
sudo zypper update
Update your system#
Update Oracle Linux to the latest available packages.
Run the following command to update your system:
sudo dnf update
Add additional package repositories#
ROCm installation packages depend on packages that aren’t included in the default package repositories. Use the following command to add the necessary repositories.
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm
sudo rpm -ivh epel-release-latest-10.noarch.rpm
sudo dnf config-manager --enable codeready-builder-for-rhel-10-x86_64-rpms
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm
sudo dnf config-manager --enable codeready-builder-for-rhel-9-x86_64-rpms
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
sudo dnf config-manager --enable codeready-builder-for-rhel-8-x86_64-rpms
Add additional package repositories#
ROCm installation packages depend on packages that aren’t included in the default package repositories. Use the following command to add the necessary repositories.
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm
sudo rpm -ivh epel-release-latest-10.noarch.rpm
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
sudo crb enable
Install additional packages#
Some ROCm tools require the libatomic and libquadmath libraries to run correctly. Install
them using your distribution’s package manager.
sudo apt install libatomic1 libquadmath0
sudo dnf install libatomic libquadmath
sudo zypper install libatomic1 libquadmath0
Install Python#
Install a supported Python version. For example, to install Python 3.12, run the following command:
sudo apt install python3.12 python3.12-venv
Install Python#
Install a supported Python version. For example, to install Python 3.11, run the following command:
sudo apt install python3.11 python3.11-venv
Install Python#
Install a supported Python version. For example, to install Python 3.13, run the following command:
sudo apt install python3.13 python3.13-venv
Install Python#
Install a supported Python version. For example, to install Python 3.11, run the following command:
sudo apt install python3.11 python3.11-venv
Install Python#
Install a supported Python version. For example, to install Python 3.12, run the following command:
sudo dnf install python3.12 python3.12-pip
Install Python#
Install a supported Python version. For example, to install Python 3.11, run the following command:
sudo dnf install python3.11 python3.11-pip
Install Python#
Install a supported Python version. For example, to install Python 3.13, run the following command:
sudo zypper install -y python313 python313-pip
Install a supported Python version. For example, to install Python 3.11, run the following command:
sudo zypper install -y python311 python311-pip
Install Python#
Install a supported Python version: 3.11, 3.12, or 3.13. See Python Releases for Windows for installation details.
Configure permissions for GPU access#
There are two primary methods of configuring GPU access for ROCm: group membership or udev rules. Each method has its own advantages. The choice depends on your specific requirements and system management preferences.
By default, GPU access is controlled by membership in the video and
render Linux system groups. The video group traditionally handles
video device access, while the render group manages GPU rendering
through DRM render nodes.
# Add the current user to the render and video groups
sudo usermod -a -G render,video $LOGNAME
udev rules are a flexible, system-wide approach for managing device permissions, eliminating the need for user group management while allowing granular GPU access. To enable them and grant GPU access to all users, run the following command:
sudo tee /etc/udev/rules.d/70-amdgpu.rules << EOF
KERNEL=="kfd", GROUP="render", MODE="0666"
SUBSYSTEM=="drm", KERNEL=="renderD*", GROUP="render", MODE="0666"
EOF
sudo udevadm control --reload-rules
sudo udevadm trigger
Note
To apply all settings, reboot your system.
Quick start#
Download and launch the interactive installer to set up ROCm and/or the AMD GPU Driver with guided, step-by-step configuration.
curl -fsSL https://repo.radeon.com/rocm/installer/rocm-runfile-installer/rocm-rel-7.12/rocm-installer-7.12.0-2.run | bash
Configuration options#
The following command line options are used to customize the runfile installer, including dependency handling and GPU access configuration. For recommended usage, go to Installation.
Dependencies#
The runfile installer controls dependency installation via the deps=
argument.
| Command | Description |
|---|---|
| Installs all required packages |
| Lists all required packages |
| Validates which required packages are installed |
Specify the target after the dependency argument; for example: deps=install rocm.
Note
It is recommended to include deps=install if you’re not sure what
dependencies are installed on your system.
GPU access#
There are two primary methods of configuring GPU access for ROCm: group membership or udev rules. The choice depends on your specific requirements and system management preferences.
The runfile installer sets GPU access at install time using the gpu-access= argument.
| Argument | Method |
|---|---|
| Group membership (adds the current user to the render and video groups) |
| udev rules (configures system-wide GPU access) |
Installation#
Before getting started, make sure you’ve completed the Prerequisites. For information about supported operating systems and compatible AMD devices, see the Compatibility matrix.
Caution
Do not copy/replace the ROCm compiler and runtime DLLs to System32 as this can cause conflicts.
Download the runfile installer#
Use the following command to download the ROCm Runfile Installer.
wget https://repo.radeon.com/rocm/installer/rocm-runfile-installer/rocm-rel-7.12/rocm-installer-7.12.0-2.run
Install the kernel driver#
For information about AMD GPU Driver (amdgpu) compatibility, see the Compatibility matrix.
For instructions on installing the AMD GPU Driver (amdgpu), see Ubuntu native installation in the AMD Instinct Data Center GPU Documentation.
For instructions on installing the AMD GPU Driver (amdgpu), see Debian native installation in the AMD Instinct Data Center GPU Documentation.
For instructions on installing the AMD GPU Driver (amdgpu), see RHEL native installation in the AMD Instinct Data Center GPU Documentation.
For instructions on installing the AMD GPU Driver (amdgpu), see Oracle Linux native installation in the AMD Instinct Data Center GPU Documentation.
For instructions on installing the AMD GPU Driver (amdgpu), see Rocky Linux native installation in the AMD Instinct Data Center GPU Documentation.
For instructions on installing the AMD GPU Driver (amdgpu), see SLES native installation in the AMD Instinct Data Center GPU Documentation.
About the kernel driver#
Supported Ryzen AI APUs require the inbox kernel driver included with Ubuntu 24.04.3.
Install the kernel driver#
For information about AMD GPU Driver (amdgpu) compatibility, see the Compatibility matrix.
bash rocm-installer-7.12.0-2.run deps=install amdgpu
Note
Reboot your system after installing the AMD GPU Driver.
Install ROCm#
Use the following instructions to install the ROCm on your system.
Register ROCm repositories#
Register the ROCm repository with your system’s package manager. This lets you install and update
ROCm packages using apt.
# Download and install GPG key
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
wget https://repo.amd.com/rocm/packages/gpg/rocm.gpg -O - | \
gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
sudo tee /etc/apt/sources.list.d/rocm.list << EOF
deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://repo.amd.com/rocm/packages/ubuntu2404 stable main
EOF
sudo apt update
# Download and install GPG key
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
wget https://repo.amd.com/rocm/packages/gpg/rocm.gpg -O - | \
gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
sudo tee /etc/apt/sources.list.d/rocm.list << EOF
deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://repo.amd.com/rocm/packages/ubuntu2204 stable main
EOF
sudo apt update
Register the ROCm repository with your system’s package manager. This enables
you to install and update ROCm packages using apt.
# Download and install GPG key
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
wget https://repo.amd.com/rocm/packages/gpg/rocm.gpg -O - | \
gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
sudo tee /etc/apt/sources.list.d/rocm.list << EOF
deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://repo.amd.com/rocm/packages/debian13 stable main
EOF
sudo apt update
# Download and install GPG key
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
wget https://repo.amd.com/rocm/packages/gpg/rocm.gpg -O - | \
gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
sudo tee /etc/apt/sources.list.d/rocm.list << EOF
deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://repo.amd.com/rocm/packages/debian12 stable main
EOF
sudo apt update
Register the ROCm repository with your system’s package manager. This enables
you to install and update ROCm packages using dnf.
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
[rocm]
name=ROCm 7.12.0
baseurl=https://repo.amd.com/rocm/packages/rhel10/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
priority=50
EOF
sudo dnf clean all
Register the ROCm repository with your system’s package manager. This enables
you to install and update ROCm packages using dnf.
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
[rocm]
name=ROCm 7.12.0
baseurl=https://repo.amd.com/rocm/packages/rhel9/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
priority=50
EOF
sudo dnf clean all
Register the ROCm repository with your system’s package manager. This enables
you to install and update ROCm packages using dnf.
sudo tee /etc/yum.repos.d/rocm.repo <<EOF
[rocm]
name=ROCm 7.12.0
baseurl=https://repo.amd.com/rocm/packages/rhel8/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
priority=50
EOF
sudo dnf clean all
Register the ROCm repository with your system’s package manager. This enables
you to install and update ROCm packages using zypper.
sudo tee /etc/zypp/repos.d/rocm.repo <<EOF
[rocm]
name=ROCm 7.12.0
baseurl=https://repo.amd.com/rocm/packages/sles16/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
priority=50
EOF
sudo zypper --gpg-auto-import-keys refresh
sudo tee /etc/zypp/repos.d/rocm.repo <<EOF
[rocm]
name=ROCm 7.12.0
baseurl=https://repo.amd.com/rocm/packages/sles15/x86_64
enabled=1
gpgcheck=1
gpgkey=https://repo.amd.com/rocm/packages/gpg/rocm.gpg
priority=50
EOF
sudo zypper --gpg-auto-import-keys refresh
Install ROCm packages#
Use apt to install the core ROCm packages. See ROCm meta
packages for additional installation
options.
sudo apt install amdrocm7.12-gfx950
sudo apt install amdrocm7.12-gfx94x
sudo apt install amdrocm7.12-gfx90a
sudo apt install amdrocm7.12-gfx908
sudo apt install amdrocm7.12-gfx120x
sudo apt install amdrocm7.12-gfx110x
sudo apt install amdrocm7.12-gfx103x
sudo apt install amdrocm7.12-gfx1151
sudo apt install amdrocm7.12-gfx1150
Use dnf to install the core ROCm packages. See ROCm meta
packages for additional installation
options.
sudo dnf install amdrocm7.12-gfx950
sudo dnf install amdrocm7.12-gfx94x
sudo dnf install amdrocm7.12-gfx90a
sudo dnf install amdrocm7.12-gfx908
sudo dnf install amdrocm7.12-gfx120x
sudo dnf install amdrocm7.12-gfx110x
sudo dnf install amdrocm7.12-gfx103x
Use zypper to install the core ROCm packages. See ROCm meta
packages for additional installation
options.
sudo zypper install amdrocm7.12-gfx950
sudo zypper install amdrocm7.12-gfx94x
sudo zypper install amdrocm7.12-gfx90a
sudo zypper install amdrocm7.12-gfx908
ROCm meta packages#
Meta packages group related components and dependencies together, allowing you to install only what is necessary for your use case. The following table describes available ROCm meta packages:
| Meta package name | Contents | Use case | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
| Runtimes, libraries, system control and monitoring tools, and other essential components. | Core runtime environment. Install this to run ROCm applications. | |
|
|
|
|
|
|
|
|
|
|
| Development environment. Install this to build ROCm applications. |
| Profilers, debuggers, and related tools. | Install this to profile, debug, and optimize ROCm applications. | |||||||||
| Components needed to run OpenCL. | Install this to run OpenCL applications on ROCm. | |||||||||
|
|
|
|
|
|
|
|
| The complete ROCm Core SDK including runtimes, compilers, development tools, and dependencies. | Install this if you need everything. |
Set up your Python virtual environment#
Create and activate the Python virtual environment where you’ll install ROCm packages.
For example, to create and activate a Python 3.12 virtual environment, run the following command:
python3.12 -m venv .venv
source .venv/bin/activate
For example, to create and activate a Python 3.11 virtual environment, run the following command:
python3.11 -m venv .venv
source .venv/bin/activate
For example, to create and activate a Python 3.13 virtual environment, run the following command:
python3.13 -m venv .venv
source .venv/bin/activate
For example, to create and activate a Python 3.11 virtual environment, run the following command:
python3.11 -m venv .venv
source .venv/bin/activate
For example, to create and activate a Python 3.12 virtual environment, run the following command:
python3.12 -m venv .venv
source .venv/bin/activate
For example, to create and activate a Python 3.11 virtual environment, run the following command:
python3.11 -m venv .venv
source .venv/bin/activate
For example, to create and activate a Python 3.13 virtual environment, run the following command:
python3.13 -m venv .venv
source .venv/bin/activate
For example, to create and activate a Python 3.11 virtual environment, run the following command:
python3.11 -m venv .venv
source .venv/bin/activate
For example, to create and activate a Python 3.12 virtual environment, run the following command:
py -3.12 -m venv .venv
.venv\Scripts\activate
Install ROCm wheel packages#
Use pip to install the ROCm Core SDK libraries and development tools for
your gfx950 GPU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools for
your gfx942 device.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx90a/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx908/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools for
your gfx1201 GPU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx120X-all/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools for
your gfx1200 GPU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx120X-all/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-all/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools for
your gfx1151 Ryzen APU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools for
your gfx1150 Ryzen APU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1150/ "rocm[libraries,devel]"
Create the installation directory#
Run the following command in your desired location to create your installation directory:
mkdir therock-tarball && cd therock-tarball
Important
Subsequent commands assume you’re working with the therock-tarball
directory. If you choose a different directory name, adjust the
commands accordingly.
Create the installation directory in C:\TheRock\build. For example,
use the following command in your command prompt:
mkdir C:\TheRock\build
Important
Subsequent commands assume you’re working with the
C:\TheRock\build directory. If you choose a different directory
name, adjust the commands accordingly.
Download and unpack the tarball#
Use the following commands to download and untar the ROCm tarball for
your gfx950 GPU.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx950-dcgpu-7.12.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball for
your gfx942 GPU.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx94X-dcgpu-7.12.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx90a-7.12.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx908-7.12.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx120X-all-7.12.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx110X-all-7.12.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball for
your gfx1151 GPU.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1151-7.12.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball for
your gfx1150 GPU.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1150-7.12.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Download the tarball and extract the contents to C:\TheRock\build.
Run the following commands in your command prompt:
cd C:\TheRock
curl -o therock-dist-windows-gfx120X-all-7.12.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx120X-all-7.12.0.tar.gz
tar -xzf therock-dist-windows-gfx120X-all-7.12.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx120X-all-7.12.0.tar.gz
cd C:\TheRock
curl -o therock-dist-windows-gfx110X-all-7.12.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx110X-all-7.12.0.tar.gz
tar -xzf therock-dist-windows-gfx110X-all-7.12.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx110X-all-7.12.0.tar.gz
cd C:\TheRock
curl -o therock-dist-windows-gfx1151-7.12.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.12.0.tar.gz
tar -xzf therock-dist-windows-gfx1151-7.12.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx1151-7.12.0.tar.gz
cd C:\TheRock
curl -o therock-dist-windows-gfx1150-7.12.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1150-7.12.0.tar.gz
tar -xzf therock-dist-windows-gfx1150-7.12.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx1150-7.12.0.tar.gz
Install the core ROCm components. See ROCm meta components for additional installation options.
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx950 gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx94x gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx90a gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx908 gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx120x gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx110x gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx103x gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx1151 gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx1150 gpu-access=user
ROCm meta components#
Meta components are similar to the meta packages used in the package manager installation method. They group related components and dependencies together, allowing you to install only what is necessary for your use case. The following table describes available ROCm meta components:
| Meta component name | Contents | Use case |
|---|---|---|
| Runtimes, libraries, system control and monitoring tools, and other essential components. | Core runtime environment. Install this to run ROCm applications. |
|
| Development environment. Install this to build ROCm applications. |
| Profilers, debuggers, and related tools. | Install this to profile, debug, and optimize ROCm applications. |
| Components needed to run OpenCL. | Install this to run OpenCL applications on ROCm. |
| The complete ROCm Core SDK including runtimes, compilers, development tools, and dependencies. | Install this if you need everything. |
The default installation uses the core meta component. To select other
components, add the compo= argument. For example, to install both core and
core-dev:
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx950 compo=core,core-dev gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx94x compo=core,core-dev gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx90a compo=core,core-dev gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx908 compo=core,core-dev gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx120x compo=core,core-dev gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx110x compo=core,core-dev gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx103x compo=core,core-dev gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx1151 compo=core,core-dev gpu-access=user
bash rocm-installer-7.12.0-2.run deps=install rocm gfx=gfx1150 compo=core,core-dev gpu-access=user
Post-installation#
After installing the ROCm Core SDK 7.12.0, complete these post-installation steps to complete your system configuration and validate the installation.
Configure your environment#
Configure environment variables so that ROCm libraries and tools are available either to all users on the system or only to your user account.
Create a profile script so that all users inherit the ROCm environment variables when they start a shell session.
sudo tee /etc/profile.d/set-rocm-env.sh << EOF
export LD_LIBRARY_PATH=/opt/rocm/core/lib/rocm_sysdeps/lib:/opt/rocm/core/lib
EOF
sudo chmod +x /etc/profile.d/set-rocm-env.sh
source /etc/profile.d/set-rocm-env.sh
Configure the ROCm environment for your user by updating your shell startup configuration file.
Use the following commands to update your shell configuration file
(~/.bashrc or ~/.profile) and add ROCm to your PATH.
tee --append ~/.bashrc << EOF
# BEGIN ROCm environment configuration
export LD_LIBRARY_PATH=/opt/rocm/core/lib/rocm_sysdeps/lib:/opt/rocm/core/lib
# END ROCm environment configuration
EOF
source ~/.bashrc
tee --append ~/.profile << EOF
# BEGIN ROCm environment configuration
export LD_LIBRARY_PATH=/opt/rocm/core/lib/rocm_sysdeps/lib:/opt/rocm/core/lib
# END ROCm environment configuration
EOF
source ~/.profile
Create a profile script so that all users inherit the ROCm environment variables when they start a shell session.
ROCM_INSTALL_PATH=$(rocm-sdk path --root)
sudo tee /etc/profile.d/set-rocm-env.sh << EOF
export ROCM_PATH=$ROCM_INSTALL_PATH
export LD_LIBRARY_PATH=\$ROCM_PATH/lib/rocm_sysdeps/lib:\$ROCM_PATH/lib/
EOF
sudo chmod +x /etc/profile.d/set-rocm-env.sh
source /etc/profile.d/set-rocm-env.sh
Configure the ROCm environment for your user by updating your shell startup configuration file.
Use the following commands to update your shell configuration file
(~/.bashrc or ~/.profile) and add ROCm to your PATH. Before proceeding, make sure you’re in the
therock-tarball directory so the install path resolves correctly.
ROCM_INSTALL_PATH=$(rocm-sdk path --root)
tee --append ~/.bashrc << EOF
# BEGIN ROCm environment configuration
export ROCM_PATH=$ROCM_INSTALL_PATH
export LD_LIBRARY_PATH=\$ROCM_PATH/lib/rocm_sysdeps/lib:\$ROCM_PATH/lib/
# END ROCm environment configuration
EOF
source ~/.bashrc
ROCM_INSTALL_PATH=$(rocm-sdk path --root)
tee --append ~/.profile << EOF
# BEGIN ROCm environment configuration
export ROCM_PATH=$ROCM_INSTALL_PATH
export LD_LIBRARY_PATH=\$ROCM_PATH/lib/rocm_sysdeps/lib:\$ROCM_PATH/lib/
# END ROCm environment configuration
EOF
source ~/.profile
Create a profile script so that all users inherit the ROCm
environment variables when they start a shell session. Make sure
you’re in the therock-tarball directory before proceeding.
# Configure ROCm PATH. Make sure you're in the therock-tarball directory before proceeding.
ROCM_INSTALL_PATH=$(pwd)/install
sudo tee /etc/profile.d/set-rocm-env.sh << EOF
export ROCM_PATH=$ROCM_INSTALL_PATH
export PATH=\$PATH:\$ROCM_PATH/bin
export LD_LIBRARY_PATH=\$ROCM_PATH/lib/rocm_sysdeps/lib:\$ROCM_PATH/lib
EOF
sudo chmod +x /etc/profile.d/set-rocm-env.sh
source /etc/profile.d/set-rocm-env.sh
Configure the ROCm environment for your user by updating your shell startup configuration file.
Use the following commands to update your shell configuration file
(~/.bashrc or ~/.profile) and add ROCm to your PATH. Before proceeding, make sure you’re in the
therock-tarball directory so the install path resolves correctly.
# Configure ROCm PATH. Make sure you're in the therock-tarball directory before proceeding.
ROCM_INSTALL_PATH=$(pwd)/install
tee --append ~/.bashrc << EOF
# BEGIN ROCm environment configuration
export ROCM_PATH=$ROCM_INSTALL_PATH
export PATH=\$PATH:\$ROCM_PATH/bin
export LD_LIBRARY_PATH=\$ROCM_PATH/lib/rocm_sysdeps/lib:\$ROCM_PATH/lib
# END ROCm environment configuration
EOF
source ~/.bashrc
# Configure ROCm PATH. Make sure you're in the therock-tarball directory before proceeding.
ROCM_INSTALL_PATH=$(pwd)/install
tee --append ~/.profile << EOF
# BEGIN ROCm environment configuration
export ROCM_PATH=$ROCM_INSTALL_PATH
export PATH=\$PATH:\$ROCM_PATH/bin
export LD_LIBRARY_PATH=\$ROCM_PATH/lib/rocm_sysdeps/lib:\$ROCM_PATH/lib
# END ROCm environment configuration
EOF
source ~/.profile
Configure your environment#
Configure environment variables so that ROCm libraries and tools are available on your Windows system.
Run command prompt as an administrator and set the following environment variables.
setx HIP_DEVICE_LIB_PATH “C:\TheRock\build\lib\llvm\amdgcn\bitcode” /M setx HIP_PATH “C:\TheRock\build” /M setx HIP_PLATFORM “amd” /M setx LLVM_PATH “C:\TheRock\build\lib\llvm” /M
Add the following paths into the PATH environment variable.
setx PATH "%PATH%;C:\TheRock\build\bin" /M setx PATH "%PATH%;C:\TheRock\build\lib\llvm\bin" /M
Open a new command prompt window for the environment variables to take effect. Run
setto see the list of active variables.set
Verify your installation#
Use the following ROCm tools to verify that the ROCm Core SDK is correctly installed and that your AMD devices are visible to the system.
Use
rocminfoto list detected AMD GPUs and confirm that the ROCm runtimes and drivers are correctly installed and loaded.rocminfo
Example output of
rocminfoROCk module version 6.18.4 is loaded ===================== HSA System Attributes ===================== Runtime Version: 1.18 Runtime Ext Version: 1.14 System Timestamp Freq.: 1000.000000MHz Sig. Max Wait Duration: 18446744073709551615 (0xFFFFFFFFFFFFFFFF) (timestamp count) Machine Model: LARGE System Endianness: LITTLE Mwaitx: DISABLED XNACK enabled: NO DMAbuf Support: YES VMM Support: YES ========== HSA Agents ========== ******* Agent 1 ******* Name: AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S Uuid: CPU-XX Marketing Name: AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S Vendor Name: CPU ... [output truncated]
Use the AMD SMI CLI
amd-smito validate system information.amd-smi versionExample output of
amd-smi versionAMDSMI Tool: 26.3.0+2bd1678d3d | AMDSMI Library version: 26.3.0 | ROCm version: 7.12.0 | amdgpu version: 6.16.13 | hsmp version: N/A | AINIC version: N/A
Inspect your installation in your Python environment and confirm that ROCm packages, including the
rocm-sdkCLI, are available.pip freeze | grep rocm which rocm-sdk ls .venv/bin
Verify your installation#
Use the following ROCm tools to verify that the ROCm Core SDK is correctly installed and that your AMD devices are visible to the system.
Use
hipinfoto list detected AMD GPUs and confirm that the ROCm runtimes and drivers are correctly installed and loaded.hipinfo
Example output of
hipinfo-------------------------------------------------------------------------------- device# 0 Name: AMD Radeon(TM) 8060S Graphics pciBusID: 197 pciDeviceID: 0 pciDomainID: 0 multiProcessorCount: 20 ... [output truncated]
Inspect your installation in your Python environment and confirm that ROCm packages, including the
rocm-sdkCLI, are available.pip freeze where rocm-sdk dir .venv\Scripts
Use hipinfo to list detected AMD GPUs and confirm that the ROCm
runtimes and drivers are correctly installed and loaded.
hipinfo
Example output of hipinfo
--------------------------------------------------------------------------------
device# 0
Name: AMD Radeon(TM) 8060S Graphics
pciBusID: 197
pciDeviceID: 0
pciDomainID: 0
multiProcessorCount: 20
... [output truncated]
Test your installation#
Run the following commands from your Python virtual environment to confirm that the ROCm SDK is correctly configured and that basic checks complete successfully.
rocm-sdk targets
rocm-sdk path --cmake
rocm-sdk path --bin
rocm-sdk path --root
rocm-sdk test
To learn more about the rocm-sdk tool and to see example expected
outputs, see Using ROCm Python packages (TheRock).
Test your installation#
Run the test_hip_api tool to verify that the HIP runtime can access
your GPU and execute a simple workload.
test_hip_api
Test your installation#
Run the following commands from your Python virtual environment to confirm that the ROCm SDK is correctly configured and that basic checks complete successfully.
rocm-sdk test
To learn more about the rocm-sdk tool and to see example expected
outputs, see Using ROCm Python packages (TheRock).
Tip
If you need to deactivate your Python virtual environment when finished, run:
deactivate
Uninstalling#
Use your package manager to remove ROCm meta packages installed on your system.
sudo apt autoremove amdrocm7.12-gfx950
sudo apt autoremove amdrocm7.12-gfx94x
sudo apt autoremove amdrocm7.12-gfx90a
sudo apt autoremove amdrocm7.12-gfx908
sudo apt autoremove amdrocm7.12-gfx120x
sudo apt autoremove amdrocm7.12-gfx110x
sudo apt autoremove amdrocm7.12-gfx103x
sudo apt autoremove amdrocm7.12-gfx1151
sudo apt autoremove amdrocm7.12-gfx1150
sudo dnf remove amdrocm7.12-gfx950
sudo dnf remove amdrocm7.12-gfx94x
sudo dnf remove amdrocm7.12-gfx90a
sudo dnf remove amdrocm7.12-gfx908
sudo dnf remove amdrocm7.12-gfx120x
sudo dnf remove amdrocm7.12-gfx110x
sudo dnf remove amdrocm7.12-gfx103x
sudo zypper remove amdrocm*
Remove ROCm repositories.
# Remove ROCm 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
# Remove ROCm repositories sudo rm /etc/yum.repos.d/rocm.repo* # Clear the cache and clean the system sudo rm -rf /var/cache/dnf sudo dnf clean all
# Remove ROCm repositories sudo zypper removerepo "rocm" # Clear the cache and clean the system sudo zypper clean --all sudo zypper refresh
Remove your ROCm environment configuration from your system.
If you opted for a system-wide setup during the installation process, remove the ROCm environment variables.
sudo rm -f /etc/profile.d/set-rocm-env.sh
If you opted for a user-specific setup during the installation process, remove the ROCm environment configuration block from your shell configuration file (
~/.bashrcor~/.profile).
Clear the pip cache.
sudo rm -rf ~/.cache/pip
pip cache purge
Remove your local Python virtual environment.
sudo rm -rf .venv
rmdir /s /q .venvRemove your ROCm environment configuration from your system.
If you opted for a system-wide setup during the installation process, remove the ROCm environment variables.
sudo rm -f /etc/profile.d/set-rocm-env.sh
If you opted for a user-specific setup during the installation process, remove the ROCm environment configuration block from your shell configuration file (
~/.bashrcor~/.profile).
To uninstall ROCm, remove your installation directory.
Important
The following command assumes you’re working with the
therock-tarballdirectory. If you chose a different directory name when installing ROCm, adjust the command accordingly.sudo rm -rf therock-tarball
Remove your ROCm environment configuration from your system.
If you opted for a system-wide setup during the installation process, remove the ROCm environment variables.
sudo rm -f /etc/profile.d/set-rocm-env.sh
If you opted for a user-specific setup during the installation process, remove the ROCm environment configuration block from your shell configuration file (
~/.bashrcor~/.profile).
To uninstall ROCm, remove your installation directory.
rmdir /s /q C:\TheRockImportant
This step assumes you’re working with the
C:\TheRock\builddirectory. If you chose a different directory name when installing ROCm, adjust this step accordingly.Run command prompt as an administrator and delete the following environment variables.
setx HIP_DEVICE_LIB_PATH "" /M setx HIP_PATH "" /M setx HIP_PLATFORM "" /M setx LLVM_PATH "" /M
Remove the following paths from your PATH environment variable using your system settings GUI. Navigate to the following screen:
Control Panel > System and Security > Edit environment variables
Edit the PATH variable and delete the following paths:
C:\TheRock\build\binC:\TheRock\build\lib\llvm\bin
To uninstall the Adrenalin Driver, see Uninstall AMD Software.
Use the following command to uninstall ROCm.
bash rocm-installer-7.12.0-2.run uninstall-rocm
Use the following command to uninstall the AMD GPU Driver (amdgpu).
bash rocm-installer-7.12.0-2.run uninstall-amdgpu