Skip to content

Update INSTALL dependencies #199

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
derobins merged 5 commits into from
Mar 16, 2026
Merged

Update INSTALL dependencies #199

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
2e60a5f
Update INSTALL dependencies
derobins Feb 27, 2026
4f7c63d
Update INSTALL.md
derobins Mar 16, 2026
073a7b9
Added additional file system and kernel notes
derobins Mar 16, 2026
5a35b46
Clean up packages
derobins Mar 16, 2026
1e3f26c
Update note about file systems
derobins Mar 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 21 additions & 3 deletions INSTALL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,10 +81,12 @@ If CMake can't find hipcc/nvcc, you can set `-DCMAKE_HIP_COMPILER=<path>`

Supported platforms: Linux (Windows may be supported in a future release)
Comment thread
derobins marked this conversation as resolved.

Supported filesystems: Only ext4 is supported at this time
Supported filesystems: Only ext4 and xfs are supported at this time. ext4 must be mounted with the default data=ordered mount option.

Targeting NVIDIA requires cuFile to be installed

The kernel must have `CONFIG_PCI_P2PDMA` enabled

Multipath NVMe devices are not supported at this time. If you are using a multipath-supporting device, you may need to disable multipath in the nvme\_core kernel driver. On Ubuntu 24.04, this can be done by running the following:

```
Expand All @@ -95,8 +97,24 @@ sudo systemctl reboot

### Prerequisites

> [!NOTE]
> hipFile relies on the unreleased [ROCm 7.2](https://github.com/ROCm/TheRock) libraries and associated [amdgpu](https://github.com/ROCm/amdgpu) drivers. We will update the install instructions when these are released.
#### Build Tools
* CMake >= 3.21
* C++ >= 17 (tested w/ clang++ & g++, we don't use GNU extensions)
* The `ais-check` script requires Python 3.x

#### AMD Components
* ROCm >= 7.2
* `hip-dev` (Debian/Ubuntu)
* `hip-devel` (RHEL/Fedora/openSUSE)
* amdgpu-dkms >= 30.20.1

#### Other Packages
* Boost.Program\_options
* `libboost-program-options-dev` (Debian/Ubuntu)
* `libboost-program-options-devel` (RHEL/Fedora/openSUSE)
* libmount
* `libmount-dev` (Debian/Ubuntu)
* `libmount-devel` (RHEL/Fedora/openSUSE)

### Configure

Expand Down
Loading