rocm-arch/README.md

ROCm for Arch Linux

This repository hosts a collection of Arch Linux PKGBUILDs for the AMD ROCm Platform. These scripts implement a great portion of the stack, ranging from low-level interfaces, over compilers to high-level application librariers.

Installation

The Arch Linux packages for ROCm are available on the AUR. Since many packages will be installed, it is recommended to use an AUR helper like yay.

It is also recommended to use the arch4edu binary repository as it will greatly speed up your installation time. For directions see Add arch4edu to your Archlinux.

To install ROCm, use

yay -S rocm-hip-sdk rocm-opencl-sdk

which includes the low-level components and compilers, utilities like rocminfo and GPU-accelerated math libraries. See the documentation for an overview on the available meta packages.

WARNING It is strongly recommended to remove all ROCm components when updating to a new release. Otherwise, building the packages with yay may have unwanted side effects resulting in build errors. If it's a small release with only a few updated packages, consider building them in a clean chroot.

One way to mitigate these issues is to use the binary versions of the packages provided by arch4edu.

You can also install specific ROCm packages like so:

yay -S rocminfo

For additional installation configuration, such as adding a user to the video group, we refer to AMD's installation guide.

To uninstall, use the following command:

yay -R rocm-hip-sdk rocm-opencl-sdk

For more helpful tips see the ArchWiki entry on ROCm, here.

Contributing

Your contribution is always welcome. Use the issue tracker to report problems with the AUR packages. Optimally, you open a pull request that solves your problem. For most packages, you have to update pkgver and sha256sums. Before you commit your changes you will need to generate .SRCINFO from the updated PKGBUILD:

makepkg --printsrcinfo > .SRCINFO

and add it to your commit. As we want to bring ROCm into community we would greatly appreciate if you test that the package builds in a clean chroot.