ROCm Optiq installation

ROCm Optiq installation#

2026-03-26

2 min read time

Applies to Linux and Windows

Install ROCm Optiq for Windows or Linux using the installation files in the ROCm/roc-optiq GitHub repository.

System requirements#

  • You must be running ROCm 7.1.0 or later for ROCm Systems Profiler database file support, and ROCm 7.12.0 or later for ROCm Compute Profiler analysis database file support.

  • Your system must be running one of these operating systems:

    • Microsoft Windows 11

    • Ubuntu 22.04 or 24.04 (Debian-based)

Note

It’s recommended to have at least 16 GB of RAM to run large traces in ROCm Optiq.

Install on Windows#

  1. Download the ROCm-Optiq-Beta.exe installer from the ROCm Optiq GitHub repo and follow the instructions in the install wizard.

    ../_images/wizard.png

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

    ../_images/agreement.png

  3. Launch roc-optiq.exe from the installation directory.

Install on Linux#

Indentify the operating system#

If you’re unsure of the Linux distribution and version, the /etc/os-release and /usr/lib/os-release files contain 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 the VERSION_ID.

Ubuntu 22.04 / 24.04 (Debian-based)#

  1. Download the .deb package from the ROCm Optiq GitHub repo.

  2. Install the .deb package:

    sudo apt install ./<file>.deb

  3. Verify the installation:

    dpkg -l | grep roc-optiq

Tip

Download the latest .deb from the ROCm Optiq GitHub repo to ensure ROCm Optiq is up-to-date.

Check the ROCm Optiq version#

Use these commands to verify the ROCm Optiq version (when installed on Ubuntu):

apt show roc-optiq

Add ROCm binaries to your PATH#

Once you’ve installed ROCm Optiq for your operating system, add the ROCm binaries to your PATH if it isn’t automatically configured:

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