Skip to content

Getting Started with CIQ Portal

This guide walks you through CIQ Portal. For an overview, see What is CIQ Portal?.

Getting Started Checklist

  1. Create an account or log in at https://portal.ciq.com
  2. Create or join an organization (create one during signup, or accept an invitation)
  3. Browse the Catalog to discover available CIQ products
  4. Select your organization using the organization switcher in the sidebar
  5. Obtain your access token from the Access Token page

Portal Navigation

After logging in, the sidebar provides access to:

  • Dashboard: Overview of your organization
  • My Products: Products your organization has access to
  • Catalog: Browse all CIQ products, start trials, or purchase access
  • Support: Submit and track support tickets
  • Resources: Links to documentation, GitHub, and the Master Service Agreement (MSA)

Admins also see:

  • Manage Organization: Members, invites, licenses, access token, event log, and settings

Organizations

CIQ Portal uses organizations to manage access to products and services. Your account can belong to multiple organizations, and you switch between them using the organization switcher in the sidebar. Your role is displayed as a badge next to each organization name.

My Account (Personal)

Every user has a personal account labeled "My Account" in the organization switcher. This provides access to non-commercial and publicly available CIQ software. You are the sole member.

Shared Organizations

Shared organizations are for CIQ customers accessing commercial software. Multiple users can belong to the same shared organization, and users can belong to multiple shared organizations.

Creating an Organization

You can create a shared organization during account signup or at any time from the Portal. When creating an organization, you provide:

  • Organization name
  • Contact name and email
  • Company name
  • Job title
  • Support ticket visibility preference

You become the Admin of any organization you create.

Joining an Organization

New users join existing organizations through an invitation:

  1. An organization admin sends you an invite from Manage > Invites
  2. You receive an email with a link to join
  3. Click the link. If you don't have a Portal account yet, you'll be prompted to create one.
  4. The shared organization appears in your organization switcher

Invitations expire after one week. If yours has expired, ask your organization admin to resend it.

Note

If your company has a CIQ organization but you haven't received an invitation, contact your organization admin and ask them to send one from Manage > Invites.

Organization Roles

Role Access Products View Token Access Support Manage Org
Admin Yes Yes Yes Yes
User Yes Yes Yes No
Support Only No No Yes No

Each Organization Has Its Own Access Token

When you switch organizations, the available products and access token change. Make sure you're in the correct organization when viewing products or copying your access token.

Product Catalog

The Catalog at https://portal.ciq.com/catalog lets you discover CIQ products. It is accessible without logging in.

From the catalog you can:

  • Browse available products
  • View product details and documentation
  • Start a free trial or developer license (requires accepting the Master Service Agreement)
  • Contact sales to purchase enterprise access

My Products

My Products at https://portal.ciq.com/products shows the products your organization has access to, with license type badges (Trial, Free, Developer, Enterprise).

From a product page, you can choose a version and then select an installation method:

  • Depot CLI: Automated repository setup commands
  • Manual DNF: Download a .repo file or copy the DNF configuration, with selectable repositories
  • Reposync: Download a .repo file or copy reposync configuration, with selectable repositories
  • Rsync: Copy rsync commands with selectable repositories

Each method includes a Show Credentials toggle and a copy button. You can also download ISOs, VM images, and verify SHA256 checksums directly from the product page.

You can switch to Classic View for a flat list of individual repositories.

Managing Your Organization

Admins manage their organization at https://portal.ciq.com/manage:

Tab What It Does
Members View, search, change roles, or remove members
Invites Send invitations (single or bulk), resend, or revoke pending invites
Licenses View licensed products, license types, dates, and node limits
Legacy Support Users View support-only users migrated from legacy systems
Access Token View, copy, or regenerate your organization's access token; link to install Depot Client
Event Log Audit trail of organization activity, filterable by type and date, exportable to CSV
Settings Update org name, contact info, company name, and ticket visibility

Licenses

  • License types: Trial, Free, Developer, Enterprise
  • Trial and developer licenses may include node limits; check your license details
  • When a license reaches its end date, access to the associated products is revoked

Access Token

  • Each organization has one token at a time
  • Regenerating a token immediately revokes the previous one
  • Only admins can regenerate tokens
  • There is no automatic notification when a token is regenerated; the action is recorded in the Event Log

Settings

  • Support ticket visibility: Controls whether organization members can see only their own support tickets or all tickets for the organization

Your User Account

Your account is tied to your email address. You can log in with a password or single sign-on (SSO) via GitHub or Google.

Access your profile at https://portal.ciq.com/settings/profile:

  • Name: Your display name
  • Email: Change your email (confirmation sent to new address)
  • Theme: Light, dark, or system default
  • Two-Factor Authentication: Add an authenticator app for extra security
  • Password: Set or change your password
  • Connections: Link or unlink GitHub and Google SSO. You must keep at least one connection if no password is set.

Under Privacy Options, you can download your data, sign out other sessions, or delete your account.

Access Credentials

Your access token page at https://portal.ciq.com/token provides:

  • Username: Your organization-specific identifier
  • Access Token: Your authentication credential

These are used together to authenticate with CIQ Depot:

sudo depot login -u YOUR_USERNAME -t YOUR_TOKEN

For details on the Depot Client, see the Installation Guide.

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 config files that contain tokens
  • Not committing tokens to version control
  • Regenerating tokens when team members leave
  • Regenerating tokens if unauthorized access is suspected

Accessing CIQ Content

Direct Downloads

Browse products in My Products, navigate to a product page, and download ISOs, KVM images, or packages directly. Verify downloads using the SHA256 checksum on the page.

HTTP Downloads (curl/wget)

Use the download commands on product pages, or construct your own:

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

Other Methods

Cloud Marketplace Customers

Images purchased through cloud marketplaces have built-in access to cloud- and region-specific mirrors.

Getting Support

See Also