Install AMD ROCm 7.11.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.11.0, see the Release notes.
Prerequisites#
Before installing the ROCm Core SDK 7.11.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.11.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.1.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 library to run correctly. Install
it using your distribution’s package manager.
sudo apt install libatomic1
sudo dnf install libatomic
sudo zypper install libatomic1
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.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.
Installation#
Installation environment
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.
Install 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 ROCm Core SDK#
Use the following instructions to install the ROCm Core SDK 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
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.11.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.11.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.11.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.11.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 refresh
sudo tee /etc/zypp/repos.d/rocm.repo <<EOF
[rocm]
name=ROCm 7.11.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 refresh
Install ROCm packages#
Use apt to install the core ROCm packages. See ROCm meta
packages for additional installation
options.
sudo apt install amdrocm7.11-gfx950
sudo apt install amdrocm7.11-gfx94x
sudo apt install amdrocm7.11-gfx90x
sudo apt install amdrocm7.11-gfx120x
sudo apt install amdrocm7.11-gfx110x
sudo apt install amdrocm7.11-gfx103x
sudo apt install amdrocm7.11-gfx1151
sudo apt install amdrocm7.11-gfx1150
Use dnf to install the core ROCm packages. See ROCm meta
packages for additional installation
options.
sudo dnf install amdrocm7.11-gfx950
sudo dnf install amdrocm7.11-gfx94x
sudo dnf install amdrocm7.11-gfx90x
sudo dnf install amdrocm7.11-gfx120x
sudo dnf install amdrocm7.11-gfx110x
sudo dnf install amdrocm7.11-gfx103x
Use zypper to install the core ROCm packages. See ROCm meta
packages for additional installation
options.
sudo zypper install amdrocm7.11-gfx950
sudo zypper install amdrocm7.11-gfx94x
sudo zypper install amdrocm7.11-gfx90x
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.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 for
your gfx90a GPU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx90X-dcgpu/ "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 for
your gfx1100 GPU.
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 gfx1101 GPU.
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 gfx1030 GPU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx103X-dgpu/ "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.11.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.11.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball for
your gfx90a GPU.
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx90X-dcgpu-7.11.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.11.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.11.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-gfx103X-dgpu-7.11.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.11.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.11.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\build
curl -o therock-dist-windows-gfx120X-all-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx120X-all-7.11.0.tar.gz
tar -xzf therock-dist-windows-gfx120X-all-7.11.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx120X-all-7.11.0.tar.gz
cd C:\TheRock\build
curl -o therock-dist-windows-gfx110X-all-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx110X-all-7.11.0.tar.gz
tar -xzf therock-dist-windows-gfx110X-all-7.11.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx110X-all-7.11.0.tar.gz
cd C:\TheRock\build
curl -o therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz
tar -xzf therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx103X-dgpu-7.11.0.tar.gz
cd C:\TheRock\build
curl -o therock-dist-windows-gfx1151-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.11.0.tar.gz
tar -xzf therock-dist-windows-gfx1151-7.11.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx1151-7.11.0.tar.gz
cd C:\TheRock\build
curl -o therock-dist-windows-gfx1150-7.11.0.tar.gz https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1150-7.11.0.tar.gz
tar -xzf therock-dist-windows-gfx1150-7.11.0.tar.gz -C build --strip-components=1
Download link: therock-dist-windows-gfx1150-7.11.0.tar.gz
Post-installation#
Installation environment
After installing the ROCm Core SDK 7.11.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. 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_PATH/llvm/lib:\$ROCM_PATH/lib/rocprofiler-systems
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 configuration file.
Add the following to your shell configuration file (
~/.bashrc,~/.profile). Make sure you’re in thetherock-tarballdirectory before proceeding.# Configure ROCm PATH. Make sure you're in the therock-tarball directory before proceeding. export ROCM_PATH=$PWD/install export PATH=$PATH:$ROCM_PATH/bin export LD_LIBRARY_PATH=$ROCM_PATH/lib:$ROCM_PATH/llvm/lib:$ROCM_PATH/lib/rocprofiler-systems
After modifying your shell configuration, apply the change to your current session by sourcing your updated shell configuration file.
source ~/.bashrc
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.2.1+7b886380f9 | AMDSMI Library version: 26.2.1 | ROCm version: 7.11.0 | amdgpu version: 6.18.4 | hsmp 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#
Installation environment
Uninstall ROCm packages#
Use your package manager to remove ROCm meta packages installed on your system.
sudo apt autoremove amdrocm7.11-gfx950
sudo apt autoremove amdrocm7.11-gfx94x
sudo apt autoremove amdrocm7.11-gfx90x
sudo apt autoremove amdrocm7.11-gfx120x
sudo apt autoremove amdrocm7.11-gfx110x
sudo apt autoremove amdrocm7.11-gfx103x
sudo apt install amdrocm7.11-gfx1151
sudo apt install amdrocm7.11-gfx1150
sudo dnf remove amdrocm7.11-gfx950
sudo dnf remove amdrocm7.11-gfx94x
sudo dnf remove amdrocm7.11-gfx90x
sudo dnf remove amdrocm7.11-gfx120x
sudo dnf remove amdrocm7.11-gfx110x
sudo dnf remove amdrocm7.11-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 Python virtual environment#
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 .venv
Remove your installation directory#
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
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
To uninstall ROCm, remove your installation directory.
rmdir /s /q C:\TheRock
Important
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.