Skip to main content

Overview

Deploy and manage applications within your Qovery environment.

Subcommands

SubcommandDescription
listList applications in the current environment
deployDeploy an application
redeployRedeploy an application
stopStop a running application
cancelCancel an application deployment
deleteDelete an application
updateUpdate an application
cloneClone an application
domainManage application custom domains
envManage application environment variables

Commands

List Applications

List all applications in current environment:
qovery application list
Output as JSON:
qovery application list --json

Deploy Application

Deploy a specific application:
qovery application deploy --application "my-api"
Deploy with a specific commit:
qovery application deploy \
  --application "my-api" \
  --commit-id "abc123def"
Deploy multiple applications at once:
qovery application deploy \
  --applications "app1,app2,app3"
Watch deployment progress:
qovery application deploy \
  --application "my-api" \
  --watch

Redeploy Application

Redeploy the same version:
qovery application redeploy --application "my-api"

Stop Application

Stop a running application:
qovery application stop --application "my-api"
Stop multiple applications:
qovery application stop --applications "app1,app2"

Cancel Deployment

Cancel an ongoing deployment:
qovery application cancel --application "my-api"

Delete Application

Delete an application:
qovery application delete --application "my-api"

Update Application

Update application configuration (branch or auto-deploy setting):
qovery application update \
  --application "my-api" \
  --branch "main"
Enable auto-deploy:
qovery application update \
  --application "my-api" \
  --auto-deploy

Options

Common flags (available on most subcommands)

FlagShorthandDescription
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name
--application-nApplication Name
--applicationsApplication Names (comma-separated), e.g. --applications "app1,app2,app3"

deploy flags

FlagShorthandDescription
--commit-id-cGit commit ID to deploy
--watch-wWatch application status until ready or error

redeploy flags

FlagShorthandDescription
--commit-id-cGit commit ID
--watch-wWatch application status until ready or error

stop flags

FlagShorthandDescription
--watch-wWatch application status until ready or error

cancel flags

FlagShorthandDescription
--watch-wWatch cancel until done or an error occurs

delete flags

FlagShorthandDescription
--watch-wWatch application status until ready or error

update flags

FlagShorthandDescription
--branchApplication Git Branch
--auto-deployEnable auto-deploy for the application

list flags

FlagShorthandDescription
--jsonJSON output

Examples

Deploy Application

# Set context first if not already set
qovery context set

# Deploy latest commit
qovery application deploy --application "my-api"

# Deploy with specific commit
qovery application deploy \
  --application "my-api" \
  --commit-id "a1b2c3d"

# Watch deployment progress
qovery application deploy \
  --application "my-api" \
  --watch

Deploy Multiple Applications

qovery application deploy \
  --applications "frontend,backend,worker"

Rollback Deployment

# Deploy a previous commit
qovery application deploy \
  --application "my-api" \
  --commit-id "previous-commit-sha"

Update Branch

qovery application update \
  --application "my-api" \
  --branch "feature/new-branch"

Additional Subcommand Groups

The application command also has the following subcommand groups for more advanced management:
  • qovery application clone — Clone an application to another environment
  • qovery application domain — Manage custom domains (list, create, delete, edit)
  • qovery application env — Manage environment variables (list, create, update, delete, alias, override)