Depot Client Maintenance¶

This guide covers keeping your Depot Client installation and repository configurations current.

Updating the Depot Client¶

The Depot Client is distributed as an RPM package. Update it using DNF:

sudo dnf update depot

Check your current version:

depot --version

Automatic Refresh¶

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

Check the timer status:

systemctl status depot-refresh.timer

View refresh logs:

journalctl -u depot-refresh

Updating Repository Credentials¶

If your organization's access token is regenerated, you'll need to update your Depot Client credentials:

sudo depot login --force -u YOUR_USERNAME -t YOUR_TOKEN

The --force flag is required to overwrite existing credentials. After re-logging in, the client automatically runs depot refresh to update all enabled product configurations with the new credentials.

Get your current credentials from https://portal.ciq.com/token.

Updating Manual Repository Configurations¶

If you configured repositories manually (without the Depot Client), update the credentials in each repository file:

sudo vi /etc/yum.repos.d/ciq-*.repo

Update the username and password fields with your new credentials.

Refreshing Repository Metadata¶

Force a refresh of repository metadata:

dnf clean metadata
dnf makecache

Checking Product Status¶

Verify which products are currently enabled:

sudo depot list --enabled

Debugging Issues¶

Use debug mode for verbose output when troubleshooting:

sudo depot --debug list