Install RCCL

Install RCCL#

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

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

Install the ROCm Core SDK#

RCCL is included with the ROCm Core SDK on Linux. For the most complete installation, we recommend that developers use the amdrocm-core-sdk meta package.

For instructions, see Install AMD ROCm. Use the selector panel on that page to view instructions appropriate for your system environment.

Install RCCL on Linux#

Alternatively, if you want to install RCCL without additional ROCm libraries and tools, install the amdrocm-rccl package. This package also includes base ROCm packages.

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

  2. Install the RCCL package that matches your ROCm version and development package needs. Package names use the following format:

    amdrocm-rccl<-dev/devel><rocm_version>

    Where:

    • <-dev/devel> specifies whether to install library files and headers. Omit this suffix to only install runtime packages.

      • -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 Core SDK version to install. Omit this suffix to install the latest available version.

    For example: amdrocm-rccl-dev7.13-gfx950

    Use the following command to install the latest RCCL development package release for supported GPU architectures:

    sudo apt install amdrocm-rccl-dev

    sudo dnf install amdrocm-rccl-devel

    sudo zypper install amdrocm-rccl-devel

Install a nightly build#

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

Contents