> ## Documentation Index
> Fetch the complete documentation index at: https://www.qovery.com/docs/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