Skip to main content

Overview

Manage container services within your Qovery environment. Containers allow you to deploy pre-built Docker images.

Commands

List Containers

List all containers in current environment:
qovery container list
Flags:
FlagDescription
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name
--jsonJSON output

Create Container

Create a new container service:
qovery container create \
  --container "my-container" \
  --registry "<registry-id>" \
  --image-name "nginx" \
  --tag "latest"
Flags:
FlagShortDescription
--container-nContainer Name (required)
--registryContainer Registry ID (required)
--image-nameContainer Image Name (required)
--tag-tContainer Image Tag (required)
--port-pContainer Port (0 = no port exposed)
--cpuCPU in millicores (default: 500)
--memoryMemory in MB (default: 512)
--min-instancesMinimum number of running instances (default: 1)
--max-instancesMaximum number of running instances (default: 1)
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name
--jsonJSON output

Deploy Container

Deploy a container:
qovery container deploy --container "my-container"
Deploy with specific image tag:
qovery container deploy \
  --container "my-container" \
  --tag "v1.2.0"
Deploy multiple containers at once:
qovery container deploy \
  --containers "container1,container2"
Flags:
FlagShortDescription
--container-nContainer Name
--containersContainer Names (comma separated)
--tag-tContainer Tag
--watch-wWatch container status until it’s ready or an error occurs
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Redeploy Container

Redeploy with same image:
qovery container redeploy --container "my-container"
Flags:
FlagShortDescription
--container-nContainer Name (required)
--watch-wWatch container status until it’s ready or an error occurs
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Stop Container

Stop a running container:
qovery container stop --container "my-container"
Stop multiple containers at once:
qovery container stop --containers "container1,container2"
Flags:
FlagShortDescription
--container-nContainer Name
--containersContainer Names (comma separated)
--watch-wWatch container status until it’s ready or an error occurs
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Cancel Deployment

Cancel a container deployment:
qovery container cancel --container "my-container"
Flags:
FlagShortDescription
--container-nContainer Name (required)
--watch-wWatch cancel until it’s done or an error occurs
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Update Container

Update a container’s image name or tag:
qovery container update \
  --container "my-container" \
  --tag "v2.0.0"
Flags:
FlagDescription
--containerContainer Name (required)
--image-nameContainer Image Name
--tagContainer Tag
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Clone Container

Clone a container to another environment or project:
qovery container clone --container "my-container"
Flags:
FlagShortDescription
--container-nContainer Name (required)
--target-projectTarget Project Name
--target-environmentTarget Environment Name
--target-container-nameTarget Container Name
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Delete Container

Delete a container service:
qovery container delete --container "my-container"
Delete multiple containers at once:
qovery container delete --containers "container1,container2"
Flags:
FlagShortDescription
--container-nContainer Name
--containersContainer Names (comma separated)
--watch-wWatch container status until it’s ready or an error occurs
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Examples

Deploy Container

# List containers
qovery container list

# Deploy container
qovery container deploy --container "nginx-proxy"

# Watch deployment status
qovery container deploy --container "nginx-proxy" --watch

Deploy Specific Image Version

# Deploy with specific tag
qovery container deploy \
  --container "nginx-proxy" \
  --tag "1.21-alpine"

List Containers as JSON

qovery container list --json