Skip to content

Working with Container Images

CIQ distributes some products as OCI container images through the Depot container registry at depot.ciq.com.

Prerequisites

  • A CIQ Portal account with access to OCI-type repositories
  • Your access credentials from https://portal.ciq.com/token
  • Docker or Podman installed on your system

Authenticating

Docker

echo YOUR_TOKEN | docker login depot.ciq.com -u YOUR_USERNAME --password-stdin

Podman

echo YOUR_TOKEN | podman login depot.ciq.com -u YOUR_USERNAME --password-stdin

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

Pulling Images

After authenticating, pull images using the path shown in the Portal:

Docker

docker pull depot.ciq.com/path/to/image:tag

Podman

podman pull depot.ciq.com/path/to/image:tag

Finding Available Images

  1. Log in to https://portal.ciq.com
  2. Navigate to My Products
  3. Look for repositories with the OCI type indicator
  4. The repository path is the image path to use with Docker/Podman

Using Images in Containerfiles

Reference CIQ images in your Containerfile or Dockerfile:

FROM depot.ciq.com/path/to/image:tag

# Your customizations here
RUN dnf install -y your-packages

Pushing to a Local Registry

To mirror images to a local registry (useful for air-gapped environments):

# Pull from CIQ
docker pull depot.ciq.com/path/to/image:tag

# Tag for your local registry
docker tag depot.ciq.com/path/to/image:tag local-registry.example.com/path/to/image:tag

# Push to your local registry
docker push local-registry.example.com/path/to/image:tag

Troubleshooting

Authentication Errors

Problem: Login fails with authentication error.

Solutions:

  • Verify your credentials are correct
  • Ensure your token hasn't been regenerated by your organization admin
  • Check that you're using credentials from the correct organization
  • Verify there are no extra spaces or characters in your username or token

Access Denied

Problem: Can't pull images or access repository.

Solutions:

  • Check that your organization has an active license for the product
  • Verify you're in the correct organization in the Portal
  • Ensure the license hasn't expired

Network Issues

Problem: Can't connect to depot.ciq.com.

Solutions:

  • Ensure your network allows HTTPS connections to depot.ciq.com (port 443)
  • Check firewall rules
  • Verify DNS resolution: nslookup depot.ciq.com
  • Test connectivity: curl -I https://depot.ciq.com
  • Check https://status.ciq.com for service issues

Image Pull Failures

Problem: Image pulls fail or timeout.

Solutions:

  • Check available disk space
  • Verify the image path and tag are correct
  • Try pulling a different image to isolate the issue
  • Check container runtime logs for specific errors

Next Steps