Skip to Content
Depot ClientGet StartedSetting Up Your Host

Setting Up Your Host

After installing the Depot Client, use it to configure CIQ repositories on your system.

Prerequisites

  • Depot Client installed and authenticated (see Installation Guide)
  • Root or sudo access on the target system

Listing Available Products

View the products available to your organization:

sudo depot list

This displays all products your organization has licensed, along with their status:

PRODUCT_ID    PRODUCT_NAME                              ENABLED
rlc-pro-9     RLC Pro 9                                 no
lts-9.4       Rocky Linux 9.4 Long Term Support         no

Filtering Products

# Show only enabled products
sudo depot list --enabled

# Show only public products
sudo depot list --public

Viewing Repositories in a Product

To see the individual repositories within a product:

sudo depot list rlc-pro-9

REPOSITORY_ID                    TYPE   OS      VERSION    ARCH
rocky-baseos-9.x86_64           dnf    rocky   9          x86_64
rocky-appstream-9.x86_64        dnf    rocky   9          x86_64

Enabling a Product

Enable a product to configure its repositories on your system:

sudo depot enable rlc-pro-9

This automatically:

  • Detects your OS, version, and architecture
  • Fetches and writes the appropriate DNF/YUM repository configuration
  • Configures authentication using your stored credentials
  • Includes GPG key URLs in the repo configuration (DNF handles key import automatically)
  • Restricts permissions on the repository files it writes (mode 0600), since they contain your access token
  • Runs any post-enable scripts for the product (for example, disabling the stock Rocky Linux repositories to avoid conflicts)

Enable Options

FlagDescription
-p, --printPreview the repo config without writing it
-y, --yesAlways run post-enable scripts
--no-post-scriptsDo not run post-enable scripts
-r, --repoEnable specific repositories within a product
-P, --providerSet the provider for the DNF configuration; use cloud-detect to detect the cloud provider automatically
--server-optsPass additional server options as URL parameters
--archOverride detected architecture
--osidOverride detected OS ID
--osversionOverride detected OS version
Post-enable scripts

Some products run a post-enable script after their repositories are configured (for example, disabling the stock Rocky Linux repositories to prevent conflicts). By default the client prompts before running these scripts. Use -y to run them without prompting (required for non-interactive automation), or --no-post-scripts to skip them.

Enabling Specific Repositories

To enable only certain repositories within a product:

sudo depot enable rlc-pro-9 --repo rocky-baseos-9.x86_64

Previewing Configuration

To see what repo configuration would be written without making changes:

sudo depot enable --print rlc-pro-9

Verifying Repository Configuration

After enabling a product, verify the repositories are configured:

sudo dnf repolist

You should see the CIQ repositories listed. Test that packages are accessible:

sudo dnf --repo=REPO_NAME list available | head

Disabling a Product

To remove a product's repository configuration:

sudo depot disable rlc-pro-9

This removes the product's repository configuration files from /etc/yum.repos.d/ and removes the product from the client's list of enabled products.

Refreshing Configuration

To regenerate the repository configuration files for all previously enabled products:

sudo depot refresh

This is useful after credential changes or to ensure configurations are current. The depot-refresh.timer systemd timer does this automatically every 7 days. For full details on the refresh command and the systemd timer, see Maintenance.

Manual Repository Configuration

If you prefer to configure repositories manually (without the Depot Client), each repository in the Portal provides a DNF Config with the repository URL and configuration details.

Create a repository file in /etc/yum.repos.d/:

[ciq-product-repo]
name=CIQ Product Repository
baseurl=https://depot.ciq.com/path/to/repo
username=YOUR_USERNAME
password=YOUR_TOKEN
enabled=1
gpgcheck=1
gpgkey=https://ciq.com/keys/rpm-gpg-key-ciq

Replace YOUR_USERNAME and YOUR_TOKEN with credentials from portal.ciq.com/token.

File Permissions

Repository configuration files contain your access token. Restrict file permissions:

sudo chmod 600 /etc/yum.repos.d/ciq-*.repo

Next Steps

Installing the Depot ClientWorking with Container Images