Install ROCm Optiq

2026-08-26

4 min read time

Applies to Linux and Windows

Install ROCm Optiq for Linux, Windows, or macOS using the installation files on the release page of the GitHub repository.

Prerequisites

The following are the prerequisites for using ROCm Optiq:

• ROCm: ROCm Optiq only visualizes profiler database files. The machine that runs ROCm Optiq doesn’t need ROCm, ROCm Systems Profiler, or ROCm Compute Profiler installed. However, see Supported data sources for the ROCm versions required for the profiling host that generates the .db file.

  Tip

  Use the following command on the profiling host to check which ROCm version is installed:

  cat /opt/rocm/.info/version
  

• Memory: At least 16 GB of RAM is recommended for working with large traces.

• Operating system: See the supported operating systems and versions below.

Supported operating systems

The following selector lists all the operating systems and installation methods for ROCm Optiq. Choose your operating system and installation method to see the supported versions and the installation instructions.

Operating system

Linux

Windows

macOS

Linux distribution

Ubuntu

RHEL

Oracle Linux

Install method

apt

tarball

Install method

dnf

tarball

Install method

dnf

tarball

Supported versions

Ubuntu 26.04, Ubuntu 24.04, and Ubuntu 22.04 are supported.

Supported versions

RHEL 10, RHEL 9, and RHEL 8 are supported.

Supported versions

Oracle Linux 10, Oracle Linux 9, and Oracle Linux 8 are supported.

Supported Windows versions

Windows 11 is supported.

Supported versions

macOS Tahoe (Version 26), macOS Sequoia (Version 15), and macOS Sonoma (Version 14) are supported.

If you’re not sure which Linux distribution or version you’re running, the /etc/os-release file contains this information:

$ cat /etc/os-release
NAME="Ubuntu"
VERSION_ID="24.04"
VERSION="24.04.3 LTS (Noble Numbat)"
VERSION_CODENAME=noble
ID=ubuntu

The relevant fields are ID and VERSION_ID.

If you’re not sure which Linux distribution or version you’re running, the /etc/os-release file contains this information:

$ cat /etc/os-release
NAME="Red Hat Enterprise Linux"
VERSION_ID="10.0"
VERSION="10.0 (Coughlan)"
ID="rhel"
ID_LIKE="fedora"

The relevant fields are ID and VERSION_ID.

If you’re not sure which Linux distribution or version you’re running, the /etc/os-release file contains this information:

$ cat /etc/os-release
NAME="Oracle Linux Server"
VERSION_ID="9.4"
VERSION="9.4"
ID="ol"
ID_LIKE="fedora"

The relevant fields are ID and VERSION_ID.

Install

1. Download the .msi installer from the ROCm Optiq GitHub Releases page and follow the instructions in the install wizard.

   

2. Accept the agreement to install, then follow the installation instructions.

   

3. Launch roc-optiq.exe from the installation directory or the Start menu.

Install using apt

1. Download the .deb package for your operating system and version from the ROCm Optiq GitHub Releases page.

2. Install the .deb package:

   sudo apt install ./roc-optiq_<version>_amd64-ubuntu-<distro-version>.deb
   

3. Verify the installation:

   dpkg -l | grep roc-optiq
   

Tip

The roc-optiq binary is installed to /opt/roc-optiq/bin. Add it to your PATH to launch by name:

export PATH=/opt/roc-optiq/bin:$PATH

Install using dnf

1. Download the .rpm package for your operating system and version from the ROCm Optiq GitHub Releases page.

2. Install the .rpm package:

   sudo dnf install ./roc-optiq-<version>-el<distro-version>.x86_64.rpm
   

3. Verify the installation:

   rpm -q roc-optiq
   

Tip

The roc-optiq binary is installed to /opt/roc-optiq/bin. Add it to your PATH to launch by name:

export PATH=/opt/roc-optiq/bin:$PATH

Install using dnf

1. Download the .rpm package for your operating system and version from the ROCm Optiq GitHub Releases page.

2. Install the .rpm package:

   sudo dnf install ./roc-optiq-<version>-el<distro-version>.x86_64.rpm
   

3. Verify the installation:

   rpm -q roc-optiq
   

Tip

The roc-optiq binary is installed to /opt/roc-optiq/bin. Add it to your PATH to launch by name:

export PATH=/opt/roc-optiq/bin:$PATH

Install using tarball

1. Download the tarball for your architecture from the ROCm Optiq GitHub Releases page.

2. Extract it to your preferred install location (no root required):

   mkdir -p "$HOME/opt/roc-optiq"
   tar -xzf roc-optiq-<version>-Linux-<distro>-<distro-version>.tar.gz -C "$HOME/opt/roc-optiq" --strip-components=1
   

3. Add ROCm Optiq to your PATH variable:

   export PATH="$HOME/opt/roc-optiq/bin:$PATH"
   

4. Verify the installation:

   roc-optiq -v
   

1. Download the .zip from the ROCm Optiq GitHub Releases page.

2. Unzip it, then drag and drop roc-optiq.app from the extracted folder to the Applications folder.

3. Launch ROCm Optiq from Applications.

Settings, logs, and presets are stored at ~/Library/Application Support/ROCm-Optiq/.

Uninstall

Go to Settings > Apps > Installed apps, select ROCm Optiq, and click Uninstall.

Uninstall using apt

sudo apt remove roc-optiq
sudo apt autoremove

Uninstall using dnf

sudo dnf remove roc-optiq

Uninstall using dnf

sudo dnf remove roc-optiq

Uninstall tarball installation

rm -rf "$HOME/opt/roc-optiq"

Then remove $HOME/opt/roc-optiq/bin from your PATH variable.

Drag roc-optiq.app from /Applications to the Trash. Optionally remove the settings directory:

rm -rf "$HOME/Library/Application Support/ROCm-Optiq"