> ## Documentation Index
> Fetch the complete documentation index at: https://qovery-docs-agent-console-2026-09-29.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# qovery service

> Service management commands

## 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:

```bash theme={null}
qovery service list
```

This displays all services regardless of type (applications, containers, databases, cronjobs, lifecycle jobs, Helm charts).

**Flags:**

| Flag | Description |
| - | - |
| `--organization` | Organization Name |
| `--project` | Project Name |
| `--environment` | Environment Name |
| `--json` | JSON output |
| `--markdown` | Markdown output |
| `--jira` | Atlassian Jira output |

### Deploy Service

Deploy a service by automatically detecting its type. Works with applications, containers, databases, jobs (cronjobs and lifecycle), and Helm charts.

```bash theme={null}
qovery service deploy --service "my-app"
```

Deploy multiple services at once:

```bash theme={null}
qovery service deploy --services "service1,service2,service3"
```

Deploy with a specific version:

```bash theme={null}
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:**

| Flag | Short | Description |
| - | - | - |
| `--service` | `-n` | Service Name |
| `--services` | | Service Names (comma separated) |
| `--version` | `-v` | Version (git commit ID, image tag, or chart version) |
| `--values-override-version` | | Helm values override version (git commit ID) |
| `--watch` | `-w` | Watch service status until it's ready or an error occurs |
| `--organization` | | Organization Name |
| `--project` | | Project Name |
| `--environment` | | Environment Name |

## Examples

### List All Services

```bash theme={null}
# 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

```bash theme={null}
qovery service list --json
```

### List Services with Markdown Output

```bash theme={null}
qovery service list --markdown
```

### Deploy a Service by Name

```bash theme={null}
# 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

## Related Commands

* [`qovery application`](/cli/commands/application) - Manage applications specifically
* [`qovery database`](/cli/commands/database) - Manage databases specifically
* [`qovery container`](/cli/commands/container) - Manage containers specifically
* [`qovery cronjob`](/cli/commands/cronjob) - Manage cronjobs specifically
* [`qovery lifecycle`](/cli/commands/lifecycle) - Manage lifecycle jobs specifically
* [`qovery helm`](/cli/commands/helm) - Manage Helm charts specifically
* [`qovery status`](/cli/commands/status) - Check service statuses