Install hipFile

Install hipFile#

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

For source builds, CMake options, and sparse-checkout layout from rocm-systems, see Build and install hipFile from source. For the Python bindings after the C library is on the machine, see Install the hipFile Python bindings.

Install the ROCm Core SDK#

hipFile ships with the ROCm Core SDK on Linux. For the broadest set of components in one step, install the amdrocm-core-sdk meta package.

For instructions, see Install AMD ROCm. Use the selector panel on that page to match your distribution and hardware.

Install hipFile on Linux#

If you want hipFile as a smaller amdrocm-* group instead of installing the full amdrocm-core-sdk stack, install the group that carries the hipFile runtime and headers for your ROCm release. Package names follow this pattern:

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

Where:

  • <-dev/-devel> selects library files and headers. Omit the suffix for runtime-only packages.

    • -dev applies on Debian-based distributions, including Ubuntu.

    • -devel applies on RPM-based distributions, including RHEL and SLES.

  • <rocm_version> pins the ROCm Core SDK version. Omit it to track the latest release your repository publishes.

  • <-llvm_target> starting with gfx limits the install to one AMD GPU architecture. Omit it to pull every supported architecture at higher disk cost.

  1. Complete the ROCm installation prerequisites so dependencies and GPU access permissions are in place.

  2. Install the amdrocm-* group that matches your ROCm version, development package needs, and GPU architecture. The exact <group> string for hipFile can change between ROCm releases. Confirm the name in the release notes for your target version before you run the package manager.

  3. Run the install command for your distribution. Replace <group> with the value from step 2.

    sudo apt update
sudo apt install amdrocm-<group>-dev

    sudo dnf install amdrocm-<group>-devel

    sudo zypper install amdrocm-<group>-devel

Install a nightly build#

The TheRock build system publishes nightly builds for the ROCm Core SDK and its components. See Nightly release status for download links and support notes.

Contents