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

• Node.js 16 or higher - Check with node --version
• npm - Included with Node.js

Install

Install the CLI globally via npm:

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

The package provides two command aliases:

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

Verify the installation:

qc --version

Authenticate

Log in to your Quant Cloud account:

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

qc whoami

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

Log out

qc logout

Project configuration

Create a .quant.yml file in your project root to automatically set context when running commands from that directory:

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

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

1. CLI flags - --org, --app, --env, --platform
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

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

qc org select
qc app select
qc env select

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

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

Multi-platform support

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

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

Variable	Description
LOG_LEVEL	Set logging verbosity: DEBUG, INFO, WARN, ERROR

Next steps

• Commands reference - Full list of management commands
• SSH access - Connect to environment containers
• Backups - Manage database and filesystem backups
• Visual regression testing - Automated visual comparison