Install HIP

Install HIP#

HIP can be installed on AMD platforms using ROCm with HIP-Clang.

Prerequisites#

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 Build HIP from source.

Install the ROCm Core SDK#

The HIP runtime is included with the ROCm Core SDK on Linux and Windows. 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.

Note

By default, when installing using your Linux distribution’s package manager, HIP is installed into /opt/rocm.

There is no autodetection for the HIP installation. If you choose to install it somewhere other than the default location, you must set the HIP_PATH environment variable as explained in Build HIP from source.

Install the ROCm runtime on Linux#

Alternatively, if you want to install the ROCm runtime package without additional ROCm libraries and tools, install the amdrocm-runtime package. This includes the HIP, base ROCm packages, and the compiler ecosystem.

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

  2. Install the ROCm runtime package that matches your desired ROCm version. Package names use the following format:

    amdrocm-runtime<rocm_version>

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

    For example, to install the latest ROCm runtime package release for supported GPU architectures:

    sudo apt install amdrocm-runtime

    sudo dnf install amdrocm-runtime

    sudo zypper install amdrocm-runtime

Install a nightly build#

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

Verify your installation#

Run hipconfig in your installation path.

/opt/rocm/bin/hipconfig --full
Contents