> ## 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 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                      |
| `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"
```

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

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