# Radeon Top

Radeon Top is an Unraid plugin that installs radeontop, enables the amdgpu kernel module, and lets Unraid users with AMD GPUs monitor total and per-block utilization in the terminal or through the GPU Statistics plugin. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4062/radeon-top

## Description

Radeon Top is an Unraid plugin that installs radeontop, enables the amdgpu kernel module, and lets Unraid users with AMD GPUs monitor total and per-block utilization in the terminal or through the GPU Statistics plugin.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

45/100 (Fair), based on 4 of 5 factors.
- Maintained: 42 (last commit 305 days ago)
- Popular: 59 (916 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 54 (no serious findings, OpenSSF Scorecard 2.3/10)

## Links

- Unraid: https://ca.unraid.net/apps/radeon-top-1qe3hho1lov7g0?q=Radeon-TOP
- GitHub: https://github.com/clbr/radeontop

## Common questions

### How can I make radeontop monitor a specific AMD GPU in Unraid instead of the default one?

Run radeontop with the -b option followed by the GPU's bus ID. For example, use -b 0f to select the GPU on bus 0f.

### Can radeontop be used with a script or dashboard instead of the interactive terminal UI?

Yes. Use the -d option to write the values to stdout instead of showing the GUI.

### What file access does radeontop need in order to read AMD GPU usage?

It requires access to /dev/dri/cardN files or /dev/mem, which generally means running with root privileges.

### Does radeontop work with the AMD Catalyst driver, or only the open-source driver?

It works with both open drivers and AMD Catalyst. With Catalyst, only the mem path is currently supported, and it will not run on default Ubuntu kernels that block /dev/mem.

### How do I force radeontop to build with amdgpu usage reporting?

Set the build option amdgpu=1, for example with make amdgpu=1. Amdgpu reporting is auto-detected by default and requires libdrm 2.4.63 or newer.

---
Source: Our Local Host (https://ourlocalhost.com/app/4062/radeon-top), the self-hosted and open-source app directory.
