Installing dpsctl

Overview

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

Prerequisites

Linux or macOS operating system
amd64 or arm64 architecture
Access to DPS GitLab Repository
- GitLab personal access token for downloading artifacts
Access to the DPS Artifactory Repositories

Download Pre-built Binary

DPS provides pre-built binaries for the following platforms:

Linux
macOS

Visit DPS GitLab Releases to see available versions.

VERSION="v0.3.3"  # e.g. v0.3.3
OS="linux"        # e.g. linux or darwin
ARCH="amd64"      # e.g. amd64, arm64

# Extract the binary
tar -xzf dpsctl_${OS}_${ARCH}_v1-${VERSION}.tgz

# Make it executable
chmod +x dpsctl

# Move to system PATH (optional)
sudo mv dpsctl /usr/local/bin/

# Verify installation
dpsctl --version

Verification

After installation, verify that dpsctl is working correctly:

# Check version
dpsctl --version

# View help
dpsctl --help

Troubleshooting

Permission Issues

# If you get permission denied
chmod +x dpsctl

# If system installation fails
sudo chown $USER:$USER dpsctl

Connection Issues

# Log in to the DPS server
dpsctl login

# Test server functionality
dpsctl verify

Authentication Issues

# Re-login if credentials expire
dpsctl login

# Check credential file
ls -la ~/.dpsctl/credentials.yaml

Next Steps

After installing dpsctl, see:

dpsctl Usage Guide - Complete command reference
[Deploy DPS](/guides/getting-started/deploy-dps/) - Set up DPS server