Skip to content
QuantCDN

Get started with the Cloud CLI

The Quant Cloud CLI (qc) is a command-line tool for managing your applications, environments, and infrastructure on the Quant Cloud Platform.

Requirements

Section titled “Requirements”
  • Node.js 16 or higher - Check with node --version
  • npm - Included with Node.js

Install

Section titled “Install”

Install the CLI globally via npm:

Terminal window
npm install -g @quantcdn/quant-cloud-cli

The package provides two command aliases:

  • quant-cloud - Full command name
  • qc - Short alias

Verify the installation:

Terminal window
qc --version

Authenticate

Section titled “Authenticate”

Log in to your Quant Cloud account:

Terminal window
qc login

This opens a browser-based OAuth flow. You’ll be prompted to select your platform:

  • QuantGov Cloud - Government & Enterprise Platform (dash.quantgov.cloud)
  • Quant Cloud - Content Delivery Platform (dashboard.quantcdn.io)

After authorizing in the browser, the CLI stores your credentials locally at ~/.quant/credentials.

Check your session

Section titled “Check your session”
Terminal window
qc whoami

Displays your email, active organization, application, environment, and token expiry.

Log out

Section titled “Log out”
Terminal window
qc logout

Project configuration

Section titled “Project configuration”

Create a .quant.yml file in your project root to automatically set the organisation, application and environment when you run commands from that directory. The file does not choose the platform. Use qc platform switch for that.

Check the active platform with qc platform current before you run a command.

Example:

org: my-organization
app: my-application
env: production

The CLI resolves context using this priority (highest first):

  1. CLI flags - --org, --app, --env
  2. Project config - .quant.yml in the current or parent directory (up to git root)
  3. Stored config - ~/.quant/credentials (set via qc org select, qc app select, etc.)

Set your active context

Section titled “Set your active context”

If you’re not using a .quant.yml file, set your active context interactively:

Terminal window
qc org select
qc app select
qc env select

Each command presents an interactive list. You can also pass the value directly:

Terminal window
qc org select my-org
qc app select my-app
qc env select production

Multi-platform support

Section titled “Multi-platform support”

The Cloud CLI supports authentication with multiple platforms simultaneously. Use the platform commands to manage connections:

Terminal window
qc platform list       # List all authenticated platforms
qc platform switch     # Switch between platforms
qc platform current    # Show active platform
qc platform remove     # Remove a platform

The short alias qc plat also works.

Environment variables

Section titled “Environment variables”
Variable Description
LOG_LEVEL Set logging verbosity: DEBUG, INFO, WARN, ERROR

Next steps

Section titled “Next steps”