qc env

Manage environments within the active application. This is the largest command group in the Cloud CLI — it covers selection, creation, observability (logs, metrics), and state control (start, stop, redeploy).

Subcommands

Command	Description
qc env list	List environments for the active application.
qc env select	Switch to a different environment.
qc env current	Show the active environment.
qc env create	Create a new environment, optionally cloning from an existing one.
qc env logs	View or tail environment logs.
qc env metrics	Open a live metrics dashboard.
qc env state stop	Stop an environment.
qc env state start	Start an environment.
qc env state redeploy	Redeploy an environment.

---

qc env list

List environments for the active application.

Synopsis

qc env list [options]

Options

Flag	Description
--org <org>	Override the active organization.
--app <app>	Override the active application.
--platform <platform>	Override the active platform.

Example

qc env list

---

qc env select

Switch the active environment.

Synopsis

qc env select [envId] [options]

Arguments

Name	Description
envId	Environment name to select. Omit for interactive selection.

Options

Flag	Description
--org <org>	Override the active organization.
--app <app>	Override the active application.
--platform <platform>	Override the active platform.

Examples

# Interactive
qc env select

# Direct
qc env select production

---

qc env current

Show the current active environment.

Synopsis

qc env current

---

qc env create

Create a new environment, optionally cloning configuration from an existing one.

Synopsis

qc env create [envName] [options]

Arguments

Name	Description
envName	Name for the new environment.

Options

Flag	Description	Default
--clone-from <envName>	Existing environment to clone configuration from.	—
--min-capacity <number>	Minimum instance capacity.	1
--max-capacity <number>	Maximum instance capacity.	10
--org <org>	Override the active organization.	—
--app <app>	Override the active application.	—
--platform <platform>	Override the active platform.	—

Examples

# Create a new environment from scratch
qc env create staging

# Clone from production
qc env create staging --clone-from production

# Create with custom scaling bounds
qc env create staging --min-capacity 2 --max-capacity 20

---

qc env logs

View or tail environment logs.

Synopsis

qc env logs [envId] [options]

Arguments

Name	Description
envId	Environment to view logs for. Defaults to the active environment.

Options

Flag	Description	Default
-f, --follow	Tail logs in real time.	false
-n, --lines <number>	Number of lines to show.	100
--org <org>	Override the active organization.	—
--app <app>	Override the active application.	—
--env <env>	Override the active environment.	—
--platform <platform>	Override the active platform.	—

Examples

# Last 100 lines
qc env logs

# Tail in real time
qc env logs -f

# Last 500 lines
qc env logs -n 500

---

qc env metrics

Display a live metrics dashboard showing CPU, memory, network, request counts, and error rates.

Synopsis

qc env metrics [envId] [options]

Arguments

Name	Description
envId	Environment to monitor. Defaults to the active environment.

Options

Flag	Description	Default
-r, --refresh <seconds>	Refresh interval in seconds.	5
--no-clear	Don’t clear the screen between updates.	—
--org <org>	Override the active organization.	—
--app <app>	Override the active application.	—
--env <env>	Override the active environment.	—
--platform <platform>	Override the active platform.	—

Examples

# Default 5-second refresh
qc env metrics

# Faster refresh
qc env metrics -r 2

# Keep history visible
qc env metrics --no-clear

---

qc env state stop

Stop the environment. Running containers are shut down.

Synopsis

qc env state stop [envId] [options]

Options

--org, --app, --env, and --platform overrides as above.

Example

qc env state stop staging

---

qc env state start

Start a stopped environment.

Synopsis

qc env state start [envId] [options]

Options

--org, --app, --env, and --platform overrides as above.

Example

qc env state start staging

---

qc env state redeploy

Redeploy an environment. Use this to roll out a new Docker image without going through the full create-or-update cycle.

Synopsis

qc env state redeploy [envId] [options]

Options

Flag	Description
--tag <imageTag>	Docker image tag to deploy.
--org <org>	Override the active organization.
--app <app>	Override the active application.
--env <env>	Override the active environment.
--platform <platform>	Override the active platform.

Example

qc env state redeploy production --tag v1.4.2

See also

• qc ssh — connect to an environment container.
• qc backup — back up environment data.
• qc app — environments live within an application.