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.
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.
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
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.
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 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 .
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 installAMD provides prerelease ROCm packages for both Debian-based and RPM-based Linux distributions.
Repository base URL:
https://rocm.prereleases.amd.com/packages/
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/nullReplace <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 updatesudo apt install amdrocm-gfx94x # Change the gfx arch based on your machine.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 allsudo dnf install amdrocm-gfx94x # Change the gfx arch based on your machine.