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

> Helm chart management commands

## Overview

Manage Helm charts within your Qovery environment.

## Commands

### List Helm Charts

List all Helm charts in current environment:

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

**Flags:**

| Flag             | Description       |
| ---------------- | ----------------- |
| `--organization` | Organization Name |
| `--project`      | Project Name      |
| `--environment`  | Environment Name  |
| `--json`         | JSON output       |

### Deploy Helm Chart

Deploy or update a Helm chart:

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

Deploy multiple charts at once:

```bash theme={null}
qovery helm deploy --helms "helm1,helm2"
```

Deploy with a specific chart version:

```bash theme={null}
qovery helm deploy --helm "my-helm" --chart_version "1.2.3"
```

**Flags:**

| Flag                              | Short | Description                                           |
| --------------------------------- | ----- | ----------------------------------------------------- |
| `--helm`                          | `-n`  | Helm Name                                             |
| `--helms`                         |       | Helm Names (comma separated)                          |
| `--chart_version`                 |       | Helm chart version                                    |
| `--chart_git_commit_id`           |       | Helm chart git commit ID                              |
| `--values_override_git_commit_id` |       | Helm values override git commit ID                    |
| `--watch`                         | `-w`  | Watch helm status until it's ready or an error occurs |
| `--organization`                  |       | Organization Name                                     |
| `--project`                       |       | Project Name                                          |
| `--environment`                   |       | Environment Name                                      |

### Redeploy Helm Chart

Redeploy an existing Helm chart with the same configuration:

```bash theme={null}
qovery helm redeploy --helm "my-helm"
```

**Flags:**

| Flag             | Short | Description                                           |
| ---------------- | ----- | ----------------------------------------------------- |
| `--helm`         | `-n`  | Helm Name (required)                                  |
| `--watch`        | `-w`  | Watch helm status until it's ready or an error occurs |
| `--organization` |       | Organization Name                                     |
| `--project`      |       | Project Name                                          |
| `--environment`  |       | Environment Name                                      |

### Stop Helm Chart

Stop a Helm chart:

```bash theme={null}
qovery helm stop --helm "my-helm"
```

Stop multiple charts at once:

```bash theme={null}
qovery helm stop --helms "helm1,helm2"
```

**Flags:**

| Flag             | Short | Description                                           |
| ---------------- | ----- | ----------------------------------------------------- |
| `--helm`         | `-n`  | Helm Name                                             |
| `--helms`        |       | Helm Names (comma separated)                          |
| `--watch`        | `-w`  | Watch helm status until it's ready or an error occurs |
| `--organization` |       | Organization Name                                     |
| `--project`      |       | Project Name                                          |
| `--environment`  |       | Environment Name                                      |

### Cancel Deployment

Cancel a Helm chart deployment:

```bash theme={null}
qovery helm cancel --helm "my-helm"
```

**Flags:**

| Flag             | Short | Description                                     |
| ---------------- | ----- | ----------------------------------------------- |
| `--helm`         | `-n`  | Helm Name (required)                            |
| `--watch`        | `-w`  | Watch cancel until it's done or an error occurs |
| `--organization` |       | Organization Name                               |
| `--project`      |       | Project Name                                    |
| `--environment`  |       | Environment Name                                |

### Update Helm Chart

Update a Helm chart's source configuration:

```bash theme={null}
qovery helm update --helm "my-helm" --chart_version "2.0.0"
```

**Flags:**

| Flag                                  | Short | Description                            |
| ------------------------------------- | ----- | -------------------------------------- |
| `--helm`                              | `-n`  | Helm Name (required)                   |
| `--chart_name`                        |       | Helm chart name                        |
| `--chart_version`                     |       | Helm chart version                     |
| `--chart_git_commit_branch`           |       | Helm chart git commit branch           |
| `--values_override_git_commit_branch` |       | Helm values override git commit branch |
| `--organization`                      |       | Organization Name                      |
| `--project`                           |       | Project Name                           |
| `--environment`                       |       | Environment Name                       |

### Clone Helm Chart

Clone a Helm chart to another environment or project:

```bash theme={null}
qovery helm clone --helm "my-helm"
```

**Flags:**

| Flag                   | Short | Description             |
| ---------------------- | ----- | ----------------------- |
| `--helm`               | `-n`  | Helm Name (required)    |
| `--target-project`     |       | Target Project Name     |
| `--target-environment` |       | Target Environment Name |
| `--target-helm-name`   |       | Target Helm Name        |
| `--organization`       |       | Organization Name       |
| `--project`            |       | Project Name            |
| `--environment`        |       | Environment Name        |

### Delete Helm Chart

Delete a Helm chart:

```bash theme={null}
qovery helm delete --helm "my-helm"
```

Delete multiple charts at once:

```bash theme={null}
qovery helm delete --helms "helm1,helm2"
```

**Flags:**

| Flag             | Short | Description                                           |
| ---------------- | ----- | ----------------------------------------------------- |
| `--helm`         | `-n`  | Helm Name                                             |
| `--helms`        |       | Helm Names (comma separated)                          |
| `--watch`        | `-w`  | Watch helm status until it's ready or an error occurs |
| `--organization` |       | Organization Name                                     |
| `--project`      |       | Project Name                                          |
| `--environment`  |       | Environment Name                                      |

## Examples

### Deploy Helm Chart

```bash theme={null}
# List Helm charts
qovery helm list

# Deploy Helm chart
qovery helm deploy --helm "redis-cluster"

# Deploy with a specific chart version
qovery helm deploy --helm "redis-cluster" --chart_version "17.0.0"

# Watch deployment status
qovery helm deploy --helm "redis-cluster" --watch
```

### List Helm Charts as JSON

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

## Related Commands

* [`qovery status`](/cli/commands/status) - Check Helm chart status
* [`qovery log`](/cli/commands/log) - View Helm chart logs