Install from Package Repositories#

This guide covers installing the dps-utils package through the system package manager on supported Linux distributions.

Install the dps-utils package version that matches the DPS server version. By default, the package manager installs the latest available version. If a matching package is unavailable, use the corresponding pre-built binary or container image.

Pre-Requisites#

  1. The system package manager has been configured to use an NVIDIA package registry for the system’s Linux distribution. For those using a CUDA local package registry on disk, it is recommended to update to the latest version available.

    Please refer to the CUDA installation guide for detailed steps.

  2. A user needs sufficient permissions to install packages through the system package manager. This could be either a root user or a user with appropriate sudo privileges.

Supported Linux Distributions#

Linux Distribution

x86_64

aarch64

Amazon Linux 2023

Azure Linux 3.0

Debian 12

RHEL 8.y/Rocky Linux 8.y

RHEL 9.y/Rocky Linux 9.y

RHEL 10.y/Rocky Linux 10.y

SLES/OpenSUSE 15.y

Ubuntu 22.04 LTS

Ubuntu 24.04 LTS

Installation#

Amazon Linux 2023#

  1. Install the dps-utils package.

    sudo dnf install --assumeyes dps-utils
    

Azure Linux 3.0#

  1. Install the dps-utils package.

    sudo tdnf install --assumeyes dps-utils
    

Ubuntu LTS and Debian#

  1. Remove any previous installations of the dps-utils package.

    sudo dpkg --list dps-utils &> /dev/null && \
      sudo apt purge --yes dps-utils
    
  2. Update the package registry cache.

    sudo apt-get update
    
  3. Install the dps-utils package.

    sudo apt-get install --yes dps-utils
    

RHEL / CentOS / Rocky Linux#

  1. Remove any previous installations of the dps-utils package.

    sudo dnf list --installed dps-utils &> /dev/null && \
      sudo dnf remove --assumeyes dps-utils
    
  2. Update the package registry cache.

    sudo dnf clean expire-cache
    
  3. Install the dps-utils package.

    sudo dnf install --assumeyes dps-utils
    

SUSE SLES / OpenSUSE#

  1. Remove any previous installations of the dps-utils package.

    sudo zypper search --installed-only --match-exact dps-utils &> /dev/null && \
      sudo zypper --non-interactive remove dps-utils
    
  2. Update the package registry cache.

    sudo zypper refresh
    
  3. Install the dps-utils package.

    sudo zypper install --no-confirm dps-utils
    

Post-Install#

Verify the installation by checking the dpsctl version:

dpsctl --version

After the server is reachable, compare this output with dpsctl server-version. Keep the package pinned according to your operating system policy so an unrelated system update does not move the client ahead of the server.