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

> Application management commands

## Overview

Deploy and manage applications within your Qovery environment.

## Subcommands

| Subcommand | Description |
| - | - |
| `list` | List applications in the current environment |
| `deploy` | Deploy an application |
| `redeploy` | Redeploy an application |
| `restart` | Restart an application without redeploying it |
| `stop` | Stop a running application |
| `cancel` | Cancel an application deployment |
| `delete` | Delete an application |
| `update` | Update an application |
| `clone` | Clone an application |
| `domain` | Manage application custom domains |
| `env` | Manage application environment variables |

## Commands

### List Applications

List all applications in current environment:

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

Output as JSON:

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

### Deploy Application

Deploy a specific application:

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

Deploy with a specific commit:

```bash theme={null}
qovery application deploy \
  --application "my-api" \
  --commit-id "abc123def"
```

Deploy multiple applications at once:

```bash theme={null}
qovery application deploy \
  --applications "app1,app2,app3"
```

Watch deployment progress:

```bash theme={null}
qovery application deploy \
  --application "my-api" \
  --watch
```

### Redeploy Application

Redeploy the same version:

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

### Restart Application

Restart a running application without redeploying it:

```bash theme={null}
qovery application restart --application "my-api"
```

Restart multiple applications and wait until they are restarted:

```bash theme={null}
qovery application restart \
  --applications "app1,app2" \
  --watch
```

<Note>
  With `--watch`, the command follows only the selected applications and exits with code 1 if one of them fails, is canceled, or no longer exists.
</Note>

### Stop Application

Stop a running application:

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

Stop multiple applications:

```bash theme={null}
qovery application stop --applications "app1,app2"
```

### Cancel Deployment

Cancel an ongoing deployment:

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

### Delete Application

Delete an application:

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

### Update Application

Update application configuration (branch or auto-deploy setting):

```bash theme={null}
qovery application update \
  --application "my-api" \
  --branch "main"
```

Enable auto-deploy:

```bash theme={null}
qovery application update \
  --application "my-api" \
  --auto-deploy
```

## Options

### Common flags (available on most subcommands)

| Flag | Shorthand | Description |
| - | - | - |
| `--organization` | | Organization Name |
| `--project` | | Project Name |
| `--environment` | | Environment Name |
| `--application` | `-n` | Application Name |
| `--applications` | | Application Names (comma-separated), e.g. `--applications "app1,app2,app3"` |

### `deploy` flags

| Flag | Shorthand | Description |
| - | - | - |
| `--commit-id` | `-c` | Git commit ID to deploy |
| `--watch` | `-w` | Watch application status until ready or error |

### `redeploy` flags

| Flag | Shorthand | Description |
| - | - | - |
| `--commit-id` | `-c` | Git commit ID |
| `--watch` | `-w` | Watch application status until ready or error |

### `restart` flags

| Flag | Shorthand | Description |
| - | - | - |
| `--watch` | `-w` | Watch application status until it's ready or an error occurs |

### `stop` flags

| Flag | Shorthand | Description |
| - | - | - |
| `--watch` | `-w` | Watch application status until ready or error |

### `cancel` flags

| Flag | Shorthand | Description |
| - | - | - |
| `--watch` | `-w` | Watch cancel until done or an error occurs |

### `delete` flags

| Flag | Shorthand | Description |
| - | - | - |
| `--watch` | `-w` | Watch application status until ready or error |

### `update` flags

| Flag | Shorthand | Description |
| - | - | - |
| `--branch` | | Application Git Branch |
| `--auto-deploy` | | Enable auto-deploy for the application |

### `list` flags

| Flag | Shorthand | Description |
| - | - | - |
| `--json` | | JSON output |

## Examples

### Deploy Application

```bash theme={null}
# Set context first if not already set
qovery context set

# Deploy latest commit
qovery application deploy --application "my-api"

# Deploy with specific commit
qovery application deploy \
  --application "my-api" \
  --commit-id "a1b2c3d"

# Watch deployment progress
qovery application deploy \
  --application "my-api" \
  --watch
```

### Deploy Multiple Applications

```bash theme={null}
qovery application deploy \
  --applications "frontend,backend,worker"
```

### Rollback Deployment

```bash theme={null}
# Deploy a previous commit
qovery application deploy \
  --application "my-api" \
  --commit-id "previous-commit-sha"
```

### Update Branch

```bash theme={null}
qovery application update \
  --application "my-api" \
  --branch "feature/new-branch"
```

## Additional Subcommand Groups

The `application` command also has the following subcommand groups for more advanced management:

* **`qovery application clone`** — Clone an application to another environment
* **`qovery application domain`** — Manage custom domains (`list`, `create`, `delete`, `edit`)
* **`qovery application env`** — Manage environment variables (`list`, `create`, `update`, `delete`, `alias`, `override`)

## Related Commands

* [`qovery log`](/cli/commands/log) - View application logs
* [`qovery shell`](/cli/commands/shell) - Access application shell
* [`qovery status`](/cli/commands/status) - Check application status