Install AMD ROCm 7.10.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.10.0, see the Release notes.
Instinct MI350X
Instinct MI300X
Instinct MI300A
Instinct MI250
Instinct MI210
Radeon PRO W7900
Radeon PRO W7800 48GB
Radeon PRO W7800
Radeon RX 7900 XT
Radeon RX 7900 GRE
Radeon RX 7700 XT
Ryzen AI Max PRO 390, 385, 380
Ryzen AI Max+ 395
Ryzen AI Max 390, 385
Ryzen AI 9 HX 370
Ryzen AI 9 365
Prerequisites#
Before installing the ROCm Core SDK 7.10.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.
Remove any existing HIP SDK for Windows installations and other conflicting AMD graphics software.
Install the Adrenalin Driver for Windows.
For general use cases, use the Adrenalin Driver version 25.11.1. For details and the download link, see AMD Software: Adrenalin Edition 25.11.1.
If you intend to run ComfyUI workloads, use driver version 25.20.01.17. For details and the download link, see AMD Software: PyTorch on Windows Edition 7.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
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 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=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
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 python3 libatomic1
dnf install sudo wget libatomic
zypper install sudo libatomic1 libgfortran5
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.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.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.
Install additional development packages#
sudo dnf install libatomic
Install additional development packages#
sudo zypper install libatomic1
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
Instinct MI350X
Instinct MI300X
Instinct MI300A
Instinct MI250
Instinct MI210
Radeon PRO W7900
Radeon PRO W7800 48GB
Radeon PRO W7800
Radeon RX 7900 XT
Radeon RX 7900 GRE
Radeon RX 7700 XT
Ryzen AI Max PRO 390, 385, 380
Ryzen AI Max+ 395
Ryzen AI Max 390, 385
Ryzen AI 9 HX 370
Ryzen AI 9 365
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.
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 RHEL native installation in the AMD Instinct Data Center GPU Documentation.
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 SLES native installation in the AMD Instinct Data Center GPU Documentation.
Install kernel driver#
For information about driver compatibility for Linux on Radeon, see the Compatibility matrix.
To download the Radeon Software for Linux package, see Linux Drivers for AMD Radeon and Radeon PRO Graphics.
About the kernel driver#
Supported Ryzen AI APUs require the inbox kernel driver included with Ubuntu 24.04.3.
Install ROCm#
Use the following instructions to install the ROCm Core SDK on your system.
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.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.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
.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 gfx1100 GPU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-dgpu/ "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-dgpu/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools for
your gfx1150 GPU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1150/ "rocm[libraries,devel]"
Use pip to install the ROCm Core SDK libraries and development tools for
your gfx1151 GPU.
Run the following command:
python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ "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.
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.
Run the following command:
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx950-dcgpu-7.10.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.
Run the following command:
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx94X-dcgpu-7.10.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.
Run the following command:
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx90X-dcgpu-7.10.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball for
your gfx1100 GPU.
Run the following command:
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx110X-dgpu-7.10.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Use the following commands to download and untar the ROCm tarball for
your gfx1101 GPU.
Run the following command:
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx110X-dgpu-7.10.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.
Run the following command:
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1150-7.10.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.
Run the following command:
wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1151-7.10.0.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Download the tarball for your gfx1100 GPU and extract the contents
to C:\TheRock\build.
Download link: therock-dist-windows-gfx110X-dgpu-7.10.0.tar.gz
Download the tarball for your gfx1101 GPU and extract the contents
to C:\TheRock\build.
Download link: therock-dist-windows-gfx110X-dgpu-7.10.0.tar.gz
Download the tarball for your gfx1150 GPU and extract the contents
to C:\TheRock\build.
Download link: therock-dist-windows-gfx1150-7.10.0.tar.gz
Download the tarball for your gfx1151 GPU and extract the contents
to C:\TheRock\build.
Download link: therock-dist-windows-gfx1151-7.10.0.tar.gz
Post-installation#
Installation environment
Instinct MI350X
Instinct MI300X
Instinct MI300A
Instinct MI250
Instinct MI210
Radeon PRO W7900
Radeon PRO W7800 48GB
Radeon PRO W7800
Radeon RX 7900 XT
Radeon RX 7900 GRE
Radeon RX 7700 XT
Ryzen AI Max PRO 390, 385, 380
Ryzen AI Max+ 395
Ryzen AI Max 390, 385
Ryzen AI 9 HX 370
Ryzen AI 9 365
After installing the ROCm Core SDK 7.10.0 – see Installation – 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
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 export PATH=$PATH:$ROCM_PATH/install/bin export LD_LIBRARY_PATH=$ROCM_PATH/install/lib
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.
Set the following environment variables using the command prompt as an administrator:
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 PATH environment variable using your system settings GUI.
C:\TheRock\build\binC:\TheRock\build\lib\llvm\bin
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 stack is correctly installed and that your AMD GPU is 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 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.1.0+cd50d9e0 | AMDSMI Library version: 26.1.0 | ROCm version: 7.10.0 | amdgpu version: 6.16.6 | amd_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 stack is correctly installed and that your AMD GPU is 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
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
Instinct MI350X
Instinct MI300X
Instinct MI300A
Instinct MI250
Instinct MI210
Radeon PRO W7900
Radeon PRO W7800 48GB
Radeon PRO W7800
Radeon RX 7900 XT
Radeon RX 7900 GRE
Radeon RX 7700 XT
Ryzen AI Max PRO 390, 385, 380
Ryzen AI Max+ 395
Ryzen AI Max 390, 385
Ryzen AI 9 HX 370
Ryzen AI 9 365
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
Delete your
C:\TheRock\buildinstallation directory and its contents.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.Delete the environment variables. For example, using PowerShell as an administrator:
[Environment]::SetEnvironmentVariable("HIP_PATH", $null, "Machine") [Environment]::SetEnvironmentVariable("HIP_DEVICE_LIB_PATH", $null, "Machine") [Environment]::SetEnvironmentVariable("HIP_PLATFORM", $null, "Machine") [Environment]::SetEnvironmentVariable("LLVM_PATH", $null, "Machine")
Remove the following paths from your PATH environment variable using your system settings GUI.
C:\TheRock\build\binC:\TheRock\build\lib\llvm\bin
If you want to uninstall the Adrenalin driver, see Uninstall AMD Software.