Accessing CIQ Content¶
This guide covers the methods for accessing CIQ software. All methods require your access token and username from https://portal.ciq.com/token.
Quick Recommendations¶
| Use Case | Recommended Method |
|---|---|
| Set up repositories on a host | Depot Client |
| Download an ISO or KVM image | Direct Download or HTTP Download |
| Mirror a full repository locally | Rsync or Reposync |
| Pull container images | Container Registry |
| Centralized enterprise content management | Red Hat Satellite |
Access Credentials¶
All content access methods require:
- Username: Found on the Access Token page
- Access Token: Found on the Access Token page
These are tied to your current organization. If you switch organizations, you'll need the new organization's credentials.
Token Security
Access tokens must be stored in plain text for tools (DNF, rsync, curl) to use them. Protect them by:
- Securing file permissions on configuration files
- Not committing tokens to version control
- Regenerating tokens when team members leave
- Regenerating if unauthorized access is suspected
Direct Downloads from Portal¶
Download files directly through your browser:
- Go to My Products at https://portal.ciq.com/products
- Select a product
- Browse to the file you want (ISOs, KVM images, packages)
- Download and verify using the SHA256 checksum on the page
HTTP Downloads¶
Use curl or wget from the command line. Download commands are available on product pages, or construct them manually:
curl -u YOUR_USERNAME:YOUR_TOKEN -O https://depot.ciq.com/path/to/your/file
wget --user=YOUR_USERNAME --password=YOUR_TOKEN https://depot.ciq.com/path/to/your/file
Depot Client¶
The recommended method for configuring repositories on hosts.
- Install the Depot Client (see Installation Guide)
- Log in:
sudo depot login -u YOUR_USERNAME -t YOUR_TOKEN - List available products:
sudo depot list - Enable a product:
sudo depot enable rlc-pro-9
See the Depot Client documentation for details.
Rsync Mirroring¶
Mirror CIQ repositories locally using rsync.
Finding the Rsync Configuration¶
- In My Products, select a product
- Choose a version, then select Manual / Netboot
- Go to the Rsync tab
- Select the repositories you want to mirror
- Click Show Credentials and copy the rsync commands
Basic Usage¶
RSYNC_PASSWORD='YOUR_TOKEN' rsync -avSHP \
rsync://YOUR_USERNAME@rsync.depot.ciq.com/REPO_PATH \
/local/mirror/path/
See the Rsync Guide for details.
Reposync¶
Mirror repositories using DNF/YUM.
Finding the Reposync Configuration¶
- In My Products, select a product
- Choose a version, then select Manual / Netboot
- Go to the Reposync tab
- Select the repositories you want to mirror
- Download the
.repofile or copy the configuration - Click Show Credentials to see the reposync commands
See the Reposync Guide for details.
Red Hat Satellite Integration¶
Integrate CIQ repositories with your Satellite infrastructure:
- Create a custom product in Satellite
- Add CIQ repositories with your access credentials
- Sync, add to Content Views, and promote through lifecycle environments
See the Satellite Guide for details.
Container Registry¶
Access CIQ container images using Docker or Podman:
echo YOUR_TOKEN | docker login depot.ciq.com -u YOUR_USERNAME --password-stdin
docker pull depot.ciq.com/path/to/image:tag
echo YOUR_TOKEN | podman login depot.ciq.com -u YOUR_USERNAME --password-stdin
podman pull depot.ciq.com/path/to/image:tag
See the Container Images Guide for details.
Cloud Marketplace Customers
Images purchased through cloud marketplaces have built-in access to cloud- and region-specific mirrors. You do not need a Portal access token for these.
See Also¶
- Getting Started Guide: Portal overview
- Organization Management: Managing access tokens and licenses
- Depot Client Installation: Installing the Depot CLI
- Troubleshooting: Common issues and solutions