ROCm/README.md
2026-02-09 12:23:46 -04:00

93 lines
2.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AMD ROCm / Pro ports for Venom Linux
Ports for **numactl**, **ROCm** (HIP, runtimes, udev), and **amdgpu-pro** (optional). Use with Venoms pkgbuild/scratch tooling.
---
## Whats in this repo
| Port | Purpose |
|------------|--------|
| **numactl** | NUMA libs/tools; required by ROCm. |
| **rocm** | ROCm platform to `/opt/rocm` + udev rules + render group (replaces a separate rocm-udev port). |
| **amdgpu-pro** | Optional. Pro installer to `/opt/amdgpu-pro`. |
---
## Prerequisites
- Venom Linux (or compatible system with **pkgbuild** and **scratch**).
- Build deps will be pulled by the ports: **autoconf**, **automake**, **libtool** (numactl); **eudev** (rocm); **bash**, **zstd** (amdgpu-pro). Install any missing system packages first if needed.
---
## Install steps
### 1. Get the ports
```bash
git clone https://git.fraggle.lol/fraggle/ports
cd ROCm
```
### 2. Build and install in this order
Use **`-i`** for initial installation of each port.
**Step 1 numactl**
```bash
cd numactl
sudo pkgbuild -i
cd ..
```
**Step 2 rocm**
```bash
cd rocm
sudo pkgbuild -i
cd ..
```
- The runfile is large; extraction can take several minutes. Packaging (xz) after “Build success” can take 515+ minutes. Let it finish.
**Step 3 (optional) amdgpu-pro**
```bash
cd amdgpu-pro
sudo pkgbuild -i
cd ..
```
**Rebuilding a port (already installed):** use **`-rcf`** when you are rebuilding a port that is already installed (e.g. after updating the spkgbuild or sources).
### 3. Use ROCm
- Ensure your user is in the **render** group (and **video** if you use it):
```bash
sudo usermod -a -G render,video $USER
```
- Log out and back in (or reboot).
- New shells get the ROCm environment from `/etc/profile.d/rocm.sh`. To use in the current shell:
```bash
source /etc/profile.d/rocm.sh
```
- Check the GPU:
```bash
rocminfo
```
---
## Summary
1. Clone this repo.
2. Build and install **numactl**, then **rocm**, then optionally **amdgpu-pro** (each: `sudo pkgbuild -i` from inside the port directory).
3. Add your user to **render** (and **video**), re-login, and source `rocm.sh` or open a new shell.