Installation Guide#

This guide includes everything you need to install and set up NVDebug on your system.

Installation Methods#

NVDebug supports the following 3 installation methods:

Method 1: Direct Download (Recommended)

Download the latest release of NVDebug from NVOnline (#1109504). Contact NVIDIA support for additional assistance.

# Extract the zip archive
unzip nvdebug-v<version>.zip

# Extract the tar.gz archive
tar -xzf nvdebug_linux_<cpu-architecture>.tar.gz

Method 2: Manual Installation

# Download the latest release
wget https://developer.download.nvidia.com/compute/cuda/repos/<os-distro>/<cpu-architecture>/nvdebug_<version>-<release-rev>_amd64.deb

# Install nvdebug
sudo dpkg -i nvdebug_<version>-<release-rev>_amd64.deb

Method 3: Package Manager (Ubuntu/Debian)

# Add NVIDIA repository
wget -qO - https://repos.nvidia.com/gpgkey | sudo apt-key add -
echo "deb https://repos.nvidia.com/ubuntu focal main" | sudo tee /etc/apt/sources.list.d/nvidia.list

# Install nvdebug
sudo apt update
sudo apt install nvdebug

Verification#

After installation, verify NVDebug is working:

# Check version
nvdebug --version

# Check help
nvdebug --help

You should see output similar to:

./nvdebug --version
NVDebug Tool Version 1.8.0
Build date: Wed Jul 30 23:32:44 PST 2025

./nvdebug --help
Usage: nvdebug -i <BMCIP> -u <BMCUSER> -p <BMCPASS> -t <PLATFORM> -b <BASEBOARD>

Commands:
Mandatory options:
   -i, --ip            Enter the BMC IP address
   -u, --user          Enter the BMC Username with administrative privilege
   -p, --password      Enter the BMC Password
...