Skip to main content

​
Overview

Manage environments and their lifecycle within your Qovery project.

​
Commands

​
List Environments

List all environments in current project: 
qovery environment list

​
Create Environment

Create a new environment: 
qovery environment create \
  --name "staging" \
  --cluster "cluster-id" \
  --mode STAGING

​
Deploy Environment

Deploy all services in an environment: 
qovery environment deploy
Deploy specific environment: 
qovery environment deploy --environment "env-id"

​
Stop Environment

Stop all services in an environment: 
qovery environment stop

​
Delete Environment

Delete an environment: 
qovery environment delete --environment "env-id"

​
Clone Environment

Clone an existing environment: 
qovery environment clone \
  --environment "production" \
  --name "staging-clone"

​
Environment Variables

​
List Variables

qovery environment env list

​
Create Variable

qovery environment env create \
  --key "API_KEY" \
  --value "secret-value" \
  --scope ENVIRONMENT
Create secret variable: 
qovery environment env create \
  --key "DATABASE_PASSWORD" \
  --value "super-secret" \
  --scope ENVIRONMENT \
  --secret

​
Update Variable

qovery environment env update \
  --key "API_KEY" \
  --value "new-value"

​
Delete Variable

qovery environment env delete --key "API_KEY"

​
Options

FlagDescription
--nameEnvironment name
--clusterCluster ID
--modeEnvironment mode (DEVELOPMENT, STAGING, PRODUCTION)
--environmentEnvironment ID or name
--keyVariable key
--valueVariable value
--scopeVariable scope (ENVIRONMENT, PROJECT, BUILT_IN)
--secretMark variable as secret
--outputOutput format (table, json, yaml)
--helpShow help

​
Examples

​
Create and Deploy Environment

# Set context
qovery context set

# Create environment
qovery environment create \
  --name "feature-auth" \
  --mode DEVELOPMENT

# Deploy all services
qovery environment deploy

# Watch deployment status
qovery status --watch

​
Manage Environment Variables

# List all variables
qovery environment env list

# Add new variable
qovery environment env create \
  --key "FEATURE_FLAG_NEW_UI" \
  --value "enabled"

# Add secret
qovery environment env create \
  --key "STRIPE_API_KEY" \
  --value "sk_test_..." \
  --secret

# Deploy to apply changes
qovery environment deploy

​
Clone Production to Staging

# Clone environment
qovery environment clone \
  --environment "production" \
  --name "staging-test"

# Deploy cloned environment
qovery environment deploy --environment "staging-test"