Install RCCL

RCCL is distributed as a prebuilt package with ROCm. The recommended way to install RCCL is to install ROCm using the package manager for your Linux distribution, which provides RCCL along with the rest of the ROCm stack.

Before you begin, verify that your system is supported. For more information, see ROCm components.

For advanced workflows, source builds, or custom configurations, see Building RCCL from source.

Note

ROCm is transitioning to a new packaging scheme. The package names you use depend on which ROCm release stream you are installing:

• ROCm 7.2 and earlier (production): packages use the rccl / rccl-dev naming scheme and are installed from the production ROCm repositories. See Install RCCL with ROCm (recommended).

• ROCm 7.13.0 technology preview (built with TheRock): packages use the new amdrocm-* naming scheme. See Install RCCL from the ROCm technology preview.

Install RCCL with ROCm (recommended)

RCCL is included with ROCm on Linux. For the most complete installation, install the full ROCm stack, which installs RCCL along with the HIP runtime and the other ROCm libraries and tools.

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

2. Install ROCm using the meta package for your distribution. This installs RCCL (the rccl runtime package) as part of the ROCm stack:

   Debian-based distros

   sudo apt install rocm
   

   RHEL-based distros

   sudo dnf install rocm
   

   SLES

   sudo zypper install rocm
   

For complete, distribution-specific instructions, see the ROCm installation guide.

Install RCCL only

If you want to install RCCL without the rest of the ROCm stack, install the RCCL package directly. The package depends on the core ROCm runtime, which is pulled in automatically.

• The runtime package is named rccl.

• The development package, which adds the library headers, is named rccl-dev on all supported distributions.

Debian-based distros

sudo apt install rccl-dev

RHEL-based distros

sudo dnf install rccl-dev

SLES

sudo zypper install rccl-dev

Install RCCL from the ROCm technology preview

The ROCm 7.13.0 technology preview is built with TheRock and uses a new amdrocm-* package naming scheme. These packages are published from the ROCm preview repositories and are intended for evaluation and development.

For the most complete installation, install the amdrocm-core-sdk meta package, which provides the full ROCm Core SDK including RCCL.

To install RCCL on its own, install the amdrocm-rccl package. RCCL package names use the following format:

amdrocm-rccl<-dev><rocm_version>

Where:

• -dev adds the library headers in addition to the runtime files. Omit this suffix to install only the runtime package.

• <rocm_version> is the ROCm Core SDK version to install. Omit this suffix to install the latest available version.

For example: amdrocm-rccl-dev7.13.

Use the following command to install the latest RCCL development package:

Debian-based distros

sudo apt install amdrocm-rccl-dev

RHEL-based distros

sudo dnf install amdrocm-rccl-dev

Install a nightly build

TheRock also publishes nightly builds for the ROCm Core SDK and its components, including RCCL. See Nightly release status for details.