rockrel (TheRock Releases)
May 8, 2026 · View on GitHub
This repository contains code and actions workflow runs for stable TheRock releases:
| ROCm release type | Repository where workflows run | Process notes |
|---|---|---|
| Stable releases | rockrel (This repository) | 🟢 Manual promotion, exhaustive QA |
| Stable prereleases | rockrel (This repository) | 🔵 Manual branching, automated tests |
| Nightly releases (multi-arch) | rockrel (This repository) | 🔵 Nightly snapshots, all GPU architectures |
| Nightly releases (per-family) | TheRock | 🔵 Nightly snapshots, per GPU family |
| Per-commit builds | TheRock, rocm-libraries, rocm-systems | 🟠 Development builds, automated tests |
The name of this repo has been shortened to workaround this known Windows path length issue.
Release FAQ (Frequently Asked Questions)
Why are some packages included in nightly releases but missing from stable releases?
We maintain a high quality bar for what we promote to "stable". If packages for a particular library, gfx target/family, or operating system do not meet this bar then the packages are not called "stable" yet.
Why are some features or subprojects missing from a particular release?
Releases must continue to be published regularly. Feature and subprojects will be included in releases only when they are ready, and the release schedule will not accept delays. Releases should be frequent enough that missing one release is not too disruptive.
The bar for "ready" is context-dependent but usually involves:
- A test plan that is sufficiently implemented
- Some incubation period in nightly releases
- Associated documentation and release notes
Installation instructions
Installing Prereleases
This provides a brief overview on how to install prereleases triggered with the workflows in this repository.
For general and more detailed information on releases, see RELEASES.md in TheRock.
Installing ROCm Python packages
Multi-arch (unified index)
Multi-arch releases use a single index URL for all GPU architectures. Select your GPU using pip extras:
pip install --index-url https://rocm.prereleases.amd.com/whl-multi-arch/ --pre "rocm[devel,device-gfx942]"
Replace device-gfx942 with the extra for your GPU (e.g. device-gfx1100,
device-gfx1201). See the
multi-arch releases section of RELEASES.md
for the full device table.
Per-family (GPU-family-specific index)
Per-family releases use a separate index URL for each GPU family:
| Product Name | GFX Target | GFX Family | Release Index |
|---|---|---|---|
| MI300A/MI300X | gfx942 | gfx94X-dcgpu | https://rocm.prereleases.amd.com/whl/gfx94X-dcgpu/ |
| MI350X/MI355X | gfx950 | gfx950-dcgpu | https://rocm.prereleases.amd.com/whl/gfx950-dcgpu/ |
| AMD Strix Halo iGPU | gfx1151 | gfx1151 | https://rocm.prereleases.amd.com/whl/gfx1151/ |
Install instructions:
python -m pip install --index-url ${Release_Index} "rocm[libraries,devel]"
For more detailed instructions see TheRock's instructions on installing releases using pip .
Installing from tarballs
Prerelease tarballs can be downloaded from https://rocm.prereleases.amd.com/tarball/.
After downloading, simply extract the release tarball into place:
mkdir therock-tarball && cd therock-tarball
# For example...
wget https://rocm.prereleases.amd.com/tarball/therock-dist-linux-gfx1151-7.9.0rc1.tar.gz
mkdir install
tar -xf *.tar.gz -C install
Installing from Native Linux Packages
AMD provides prerelease ROCm packages for both Debian-based and RPM-based Linux distributions.
Repository base URL:
https://rocm.prereleases.amd.com/packages/
Installing Packages on Debian-Based Systems
Import the ROCm GPG Key
sudo mkdir --parents --mode=0755 /etc/apt/keyrings
wget https://rocm.prereleases.amd.com/packages/gpg/rocm.gpg -O - \
| gpg --dearmor | sudo tee /etc/apt/keyrings/amdrocm.gpg > /dev/null
Add the ROCm Repository
Replace <os_profile> with the appropriate distribution profile
(e.g. debian12, ubuntu2404).
sudo tee /etc/apt/sources.list.d/rocm.list << EOF
deb [arch=amd64 signed-by=/etc/apt/keyrings/amdrocm.gpg] https://rocm.prereleases.amd.com/packages/<os_profile> stable main
EOF
sudo apt update
Install ROCm
sudo apt install amdrocm-gfx94x # Change the gfx arch based on your machine.
Installing Packages on RPM-Based Systems
Add the ROCm Repository
Replace <os_profile> with the appropriate distribution profile
(e.g. rhel8, sles16).
sudo tee /etc/yum.repos.d/rocm.repo << EOF
[rocm]
name=ROCm Prerelease Repository
baseurl=https://rocm.prereleases.amd.com/packages/<os_profile>/x86_64/
enabled=1
gpgcheck=1
gpgkey=https://rocm.prereleases.amd.com/packages/gpg/rocm.gpg
EOF
sudo dnf clean all
Install ROCm
sudo dnf install amdrocm-gfx94x # Change the gfx arch based on your machine.