Skip to main content

Overview

Manage all types of services within your Qovery environment. This is a unified command to list and deploy services across applications, containers, databases, jobs, and Helm charts.

Commands

List Services

List all services in current environment:
qovery service list
This displays all services regardless of type (applications, containers, databases, cronjobs, lifecycle jobs, Helm charts). Flags:
FlagDescription
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name
--jsonJSON output
--markdownMarkdown output
--jiraAtlassian Jira output

Deploy Service

Deploy a service by automatically detecting its type. Works with applications, containers, databases, jobs (cronjobs and lifecycle), and Helm charts.
qovery service deploy --service "my-app"
Deploy multiple services at once:
qovery service deploy --services "service1,service2,service3"
Deploy with a specific version:
qovery service deploy --service "my-app" --version "abc123"
The --version parameter accepts:
  • Git commit IDs (for applications, git-based jobs, git-based helms)
  • Container image tags (for containers, image-based jobs)
  • Helm chart versions (for helm repository charts)
Flags:
FlagShortDescription
--service-nService Name
--servicesService Names (comma separated)
--version-vVersion (git commit ID, image tag, or chart version)
--values-override-versionHelm values override version (git commit ID)
--watch-wWatch service status until it’s ready or an error occurs
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Examples

List All Services

# Set context
qovery context set

# List all services in environment
qovery service list

# Example output:
# NAME              TYPE           STATUS
# my-api            Application    Running
# postgres-db       Database       Running
# redis-cache       Container      Running
# backup-job        Cronjob        Running
# db-migration      Lifecycle      Completed

List Services with JSON Output

qovery service list --json

List Services with Markdown Output

qovery service list --markdown

Deploy a Service by Name

# Deploy an application
qovery service deploy --service "my-api"

# Deploy a container with a specific tag
qovery service deploy --service "my-container" --version "v1.2.3"

# Deploy a helm chart with a specific version
qovery service deploy --service "my-helm" --version "1.2.3"

# Deploy multiple services
qovery service deploy --services "frontend,backend,worker"

Service Types

The service list command displays all the following service types:
  • Application - Applications built from Git repositories
  • Container - Pre-built Docker images
  • Database - Managed databases (PostgreSQL, MySQL, MongoDB, Redis, etc.)
  • Cronjob - Scheduled jobs
  • Lifecycle - Lifecycle jobs (run on specific events)
  • Helm - Helm charts