Install ROCm Debugger (ROCgdb)

Before you begin, verify that your system is supported. For more information, see ROCm Core SDK components.

For advanced workflows, source builds, or custom configurations, see Build the AMD ROCm Debugger.

Install the ROCm Core SDK

ROCdbgapi is included with the ROCm Core SDK on Linux. For the most complete installation, we recommend that developers use the amdrocm-core-sdk meta package.

For instructions, see Install AMD ROCm. Use the selector panel on that page to view instructions appropriate for your system environment.

Install ROCm debuggers on Linux

Alternatively, if you want to install ROCgdb as part of the ROCm Debugger package (a subset of the ROCm Core SDK amdrocm-core-sdk) without additional ROCm libraries and tools, install the amdrocm-debugger package. This includes the ROCm debuggers, dependencies, and base packages.

1. Complete the ROCm installation prerequisites to install dependencies and configure GPU access permissions.

2. Install the ROCm Debugger package that matches your desired ROCm version. Package names use the following format:

   amdrocm-debugger<rocm_version>
   

   Where <rocm_version> is the ROCm Core SDK version to install. Omit this suffix to install the latest available version.

   For example, to install the latest ROCm Debugger package release for supported GPU architectures:

   Debian-based distros

   sudo apt install amdrocm-debugger
   

   RHEL-based distros

   sudo dnf install amdrocm-debugger
   

   SLES

   sudo zypper install amdrocm-debugger
   

Install a nightly build

The TheRock build system also publishes nightly builds for the ROCm Core SDK and its components, including ROCgdb. See Nightly release status for details.