Install rocALUTION

Install rocALUTION#

You can install rocALUTION on Linux from prebuilt packages either as part of the ROCm HPC SDK, as standalone packages, or from a ROCm Core SDK tarball release. Before you begin, verify that your operating system and environment are supported using the installation selector on Install ROCm HPC SDK.

For advanced workflows, source builds, or custom configurations, see Build rocALUTION from source.

Install the ROCm HPC SDK#

rocALUTION is part of the ROCm HPC SDK on Linux. It is not included in the ROCm Core SDK through the standard amdrocm metapackage; it is installed through the opt-in amdrocm-hpc-sdk metapackage. This is the recommended installation method for the most complete installation.

For instructions, see Install ROCm HPC SDK and use the selector panel to view instructions for your system environment. For ROCm core installation, see Install AMD ROCm.

Install rocALUTION standalone on Linux#

Alternatively, you can use the amdrocm-rocalution packages to install rocALUTION without the full ROCm HPC SDK.

Complete the ROCm installation prerequisites to install dependencies and configure GPU access permissions.

Install the rocALUTION packages that match your desired ROCm version, development package needs, and AMD GPU architecture. Package names use the following format:

amdrocm-rocalution<rocm_version><-llvm_target>
amdrocm-rocalution<-dev/-devel><rocm_version>

Where:

<-dev/-devel> is the development package suffix (headers and CMake configuration files):
- -dev is used on Debian-based distributions, including Ubuntu.
- -devel is used on RPM-based distributions, including RHEL and SLES.
<rocm_version> is the ROCm version to install (for example, 10.2). Omit this suffix to install the latest available version. If you include <-llvm_target>, also include <rocm_version> (for example, amdrocm-rocalution10.2-gfx950).
<-llvm_target> (starting with gfx) is used on the runtime package if you are installing for a single AMD GPU architecture. Omit this to install for all architectures at the cost of disk space. To find the LLVM target for an installed GPU, run rocminfo | grep gfx.

Supported GPUs and GFX targets

GPU series	Architecture	LLVM target
AMD Instinct MI350 series	CDNA 4	`gfx950`
AMD Instinct MI300 series	CDNA 3	`gfx942`
AMD Instinct MI200 series	CDNA 2	`gfx90a`
AMD Instinct MI100 series	CDNA	`gfx908`
AMD Radeon AI PRO R9000 / RX 9000 series	RDNA 4	`gfx1200`, `gfx1201`
AMD Radeon PRO W7000 / RX 7000 / PRO V series	RDNA 3	`gfx1100`, `gfx1101`, `gfx1102`
AMD Radeon PRO W6000 series	RDNA 2	`gfx1030`
AMD Ryzen integrated graphics	RDNA 3, RDNA 3.5	`gfx1103`, `gfx1150`, `gfx1151`, `gfx1152`, `gfx1153`

For example: amdrocm-rocalution10.2-gfx950 and amdrocm-rocalution-dev10.2

Use the following commands to install the latest rocALUTION runtime and development packages for supported GPU architectures:

Debian-based distros

sudo apt install amdrocm-rocalution amdrocm-rocalution-dev

RHEL-based distros

sudo dnf install amdrocm-rocalution amdrocm-rocalution-devel

SLES

sudo zypper install amdrocm-rocalution amdrocm-rocalution-devel

Install from a tarball#

The standard ROCm Core SDK tarball installation includes rocALUTION. No additional steps are required. For details, see Install AMD ROCm and select the tarball installation method.

The standard ROCm uninstallation process removes rocALUTION. No additional steps are required.

Install a nightly build#

The TheRock build system also publishes nightly builds for ROCm and its components, including rocALUTION. See Nightly release status for details.

Verify your installation#

After installing the runtime and development packages (or the ROCm HPC SDK), you can verify your installation by compiling and running a minimal smoke test.

Create a file named test_rocalution.cpp:

#include <rocalution/rocalution.hpp>

int main() {
    rocalution::init_rocalution();
    rocalution::info_rocalution();
    rocalution::stop_rocalution();
    return 0;
}

Compile and run the program:
```
hipcc test_rocalution.cpp -lrocalution -o test_rocalution
./test_rocalution
```
If rocALUTION is installed properly, the program prints the rocALUTION version, confirms that the platform and HIP accelerator backend are initialized, and lists your detected AMD GPU.

Uninstall rocALUTION#

If you installed versioned or architecture-specific packages, substitute the exact package names used during installation (for example, amdrocm-rocalution10.2-gfx950 and amdrocm-rocalution-dev10.2 or amdrocm-rocalution-devel10.2).