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 vars	List, get, set and unset environment variables (0.7.0 or later).

---

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.

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.

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.	—

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.	—

Examples

# Last 100 lines
qc env logs

# Tail in real time
qc env logs -f

# Last 500 lines
qc env logs -n 500

--lines only trims the entries that the platform returns. If the platform returns fewer entries than you ask for, qc prints those. For a longer window, use the logs page in the dashboard. With --follow, qc checks for new entries about every two seconds.

---

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.	—

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 and --env 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 and --env 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.

Example

qc env state redeploy production --tag v1.4.2

stop, start and redeploy do not ask for confirmation. Check the target with qc env current before you run them on production.

See also

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