Skip to content

Installing the Depot Client

The Depot Client (depot) is a command-line tool that automates repository configuration on your systems.

Prerequisites

  • A CIQ Portal account with an active organization
  • Your access credentials from https://portal.ciq.com/token
  • Root or sudo access on the target system
  • Rocky Linux, RHEL, or another RPM-based distribution (EL-compatible)

Installation

Add the CIQ public repository and install:

sudo dnf config-manager --add-repo https://depot.ciq.com/dlv2/depot-el\$releasever.\$basearch/
sudo rpm --import https://ciq.com/keys/rpm-gpg-key-ciq
sudo dnf install depot

From Portal

A direct link to the Depot Client installation is also available on the Access Token page in the Portal.

Authenticating

After installation, log in with your access token from the Portal:

sudo depot login -u YOUR_USERNAME -t YOUR_TOKEN

Replace YOUR_USERNAME and YOUR_TOKEN with the credentials from your Access Token page.

You should see:

Connected to https://depot.ciq.com

Root Required

The Depot Client must be run with root privileges (sudo) because it writes repository configuration files and stores credentials in root-owned, permission-restricted files.

Login Options

Flag Description
-u, --user Username (required)
-t, --token Access token (required)
-s, --server Server URL (default: https://depot.ciq.com)
-f, --force Force re-login over existing credentials

You can also set credentials via environment variables: DEPOT_USER, DEPOT_TOKEN, DEPOT_SERVER.

Verifying Installation

Check that the Depot Client is installed and authenticated:

sudo depot list

This displays the products available to your organization:

PRODUCT_ID    PRODUCT_NAME                              ENABLED
rlc-pro-9     RLC Pro 9                                 no
lts-9.4       Rocky Linux 9.4 Long Term Support         no
bridge        CIQ Bridge (CentOS 7 extended life)       no

Check your installed version:

depot --version

Depot Client Commands

Command Description
depot login Authenticate with CIQ Depot
depot list List available products (alias: ls)
depot enable Enable products and configure repositories
depot disable Disable products and remove repo configuration
depot refresh Re-enable/refresh all previously enabled products
depot download Download a file from Depot
depot help Display help for any command

Global Flags

Flag Description
-d, --debug Enable debug mode with verbose output
-j, --json Output in JSON format
-v, --version Show version information

Automatic Refresh

The Depot Client installs a systemd timer (depot-refresh.timer) that automatically refreshes your enabled product configurations every 7 days. This ensures your repository configurations stay current.

View refresh logs:

journalctl -u depot-refresh

Next Steps