rockrel (TheRock Releases)

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:

1. A test plan that is sufficiently implemented
2. Some incubation period in nightly releases
3. 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 releases use a single index URL for all GPU architectures. Use device-all for all supported GPUs, or one family with a [device-*] extra:

pip install --index-url https://rocm.prereleases.amd.com/whl-multi-arch/ --pre \
  "rocm[libraries,devel,device-all]"
# For a specific GPU family instead, e.g.:
# "rocm[libraries,devel,device-gfx942]"

See the multi-arch releases section of RELEASES.md for the device extras table and full install instructions.

Installing from tarballs

Prerelease tarballs can be downloaded from https://rocm.prereleases.amd.com/tarball-multi-arch/.

After downloading, extract the release tarball into place:

mkdir therock-tarball && cd therock-tarball

# Multiarch (all GPUs):
wget https://rocm.prereleases.amd.com/tarball-multi-arch/therock-dist-linux-multiarch-7.14.0rc1.tar.gz

# Per-family (one GPU family):
# wget https://rocm.prereleases.amd.com/tarball-multi-arch/therock-dist-linux-gfx94X-dcgpu-7.14.0rc1.tar.gz

mkdir install
tar -xf *.tar.gz -C install

Pick the tarball that matches your GPU family and ROCm version from the index (e.g. gfx1151, gfx950-dcgpu). Use the multiarch tarball to install all supported GPU families at once.

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-multi-arch/

---

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

The example below uses the ubuntu2404 profile; change it to match your distribution (e.g. debian12, ubuntu2204, ubuntu2604).

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-multi-arch/ubuntu2404/ stable main
EOF
sudo apt update

---

Install ROCm

# Installs the full ROCm core SDK.
sudo apt install amdrocm-core
# For a specific ROCm version and GPU arch instead, e.g.:
# sudo apt install amdrocm7.14-gfx942

---

Installing Packages on RPM-Based Systems

Add the ROCm Repository

The example below uses the rhel10 profile; change it to match your distribution (e.g. rhel8, rhel9, sles15, sles16).

sudo tee /etc/yum.repos.d/rocm.repo << EOF
[rocm]
name=ROCm Prerelease Repository
baseurl=https://rocm.prereleases.amd.com/packages-multi-arch/rhel10/x86_64/
enabled=1
gpgcheck=1
gpgkey=https://rocm.prereleases.amd.com/packages/gpg/rocm.gpg
EOF
sudo dnf clean all

---

Install ROCm

# Installs the full ROCm core SDK.
sudo dnf install amdrocm-core
# For a specific ROCm version and GPU arch instead, e.g.:
# sudo dnf install amdrocm7.14-gfx942