Skip to content

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)

Enable Options

Flag Description
-p, --print Preview the repo config without writing it
-y, --yes Auto-run post-enable scripts without prompting
-r, --repo Enable specific repositories within a product
--arch Override detected architecture
--osid Override detected OS ID
--osversion Override detected OS version

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:

dnf repolist

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

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 repository configuration from your system.

Refreshing Configuration

To re-apply configuration 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.

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