Installing dpsctl#

Overview#

This guide provides a step-by-step process for installing the DPS command-line client.

Choose the dpsctl release that matches the DPS server and Helm chart selected in Deployment and Configuration Guide. Do not rely on a floating container tag or an unpinned package update. There are three install paths:

  1. Install via Container (recommended) - Run dpsctl as a container, optionally fronted by a small shell wrapper so it behaves like a native dpsctl binary.

  2. Install Pre-built Binary - Download a platform-specific dpsctl binary from the NVIDIA Partner Portal.

  3. Install from Package Repositories - Install the dps-utils package through the system package manager.

Prerequisites#

  • Linux or macOS operating system

  • amd64 or arm64 architecture

  • Docker (or a compatible OCI runtime such as Podman) for the container install path

Verification#

After installation, verify that dpsctl is working correctly:

dpsctl --version

dpsctl --help

After the server is installed, authenticate and compare both sides:

dpsctl login
dpsctl server-version
dpsctl --version

If the versions differ, install the client artifact from the server release before using mutating commands.

Troubleshooting#

Permission Issues#

chmod +x dpsctl

sudo chown $USER:$USER dpsctl

Connection Issues#

Use Cannot Connect or Log In for endpoint, TLS, authentication, and authorization failures.

Next Steps#

After installing dpsctl, see: