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

> Container management commands

## Overview

Manage container services within your Qovery environment. Containers allow you to deploy pre-built Docker images.

## Commands

### List Containers

List all containers in current environment:

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

**Flags:**

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

### Create Container

Create a new container service:

```bash theme={null}
qovery container create \
  --container "my-container" \
  --registry "<registry-id>" \
  --image-name "nginx" \
  --tag "latest"
```

**Flags:**

| Flag | Short | Description |
| - | - | - |
| `--container` | `-n` | Container Name (required) |
| `--registry` | | Container Registry ID (required) |
| `--image-name` | | Container Image Name (required) |
| `--tag` | `-t` | Container Image Tag (required) |
| `--port` | `-p` | Container Port (0 = no port exposed) |
| `--cpu` | | CPU in millicores (default: 500) |
| `--memory` | | Memory in MB (default: 512) |
| `--min-instances` | | Minimum number of running instances (default: 1) |
| `--max-instances` | | Maximum number of running instances (default: 1) |
| `--organization` | | Organization Name |
| `--project` | | Project Name |
| `--environment` | | Environment Name |
| `--json` | | JSON output |

### Deploy Container

Deploy a container:

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

Deploy with specific image tag:

```bash theme={null}
qovery container deploy \
  --container "my-container" \
  --tag "v1.2.0"
```

Deploy multiple containers at once:

```bash theme={null}
qovery container deploy \
  --containers "container1,container2"
```

**Flags:**

| Flag | Short | Description |
| - | - | - |
| `--container` | `-n` | Container Name |
| `--containers` | | Container Names (comma separated) |
| `--tag` | `-t` | Container Tag |
| `--watch` | `-w` | Watch container status until it's ready or an error occurs |
| `--organization` | | Organization Name |
| `--project` | | Project Name |
| `--environment` | | Environment Name |

### Redeploy Container

Redeploy with same image:

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

**Flags:**

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

### Restart Container

Restart a running container without redeploying it:

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

Restart multiple containers at once:

```bash theme={null}
qovery container restart --containers "container1,container2"
```

**Flags:**

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

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

### Stop Container

Stop a running container:

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

Stop multiple containers at once:

```bash theme={null}
qovery container stop --containers "container1,container2"
```

**Flags:**

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

### Cancel Deployment

Cancel a container deployment:

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

**Flags:**

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

### Update Container

Update a container's image name or tag:

```bash theme={null}
qovery container update \
  --container "my-container" \
  --tag "v2.0.0"
```

**Flags:**

| Flag | Description |
| - | - |
| `--container` | Container Name (required) |
| `--image-name` | Container Image Name |
| `--tag` | Container Tag |
| `--organization` | Organization Name |
| `--project` | Project Name |
| `--environment` | Environment Name |

### Clone Container

Clone a container to another environment or project:

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

**Flags:**

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

### Delete Container

Delete a container service:

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

Delete multiple containers at once:

```bash theme={null}
qovery container delete --containers "container1,container2"
```

**Flags:**

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

## Examples

### Deploy Container

```bash theme={null}
# List containers
qovery container list

# Deploy container
qovery container deploy --container "nginx-proxy"

# Watch deployment status
qovery container deploy --container "nginx-proxy" --watch
```

### Deploy Specific Image Version

```bash theme={null}
# Deploy with specific tag
qovery container deploy \
  --container "nginx-proxy" \
  --tag "1.21-alpine"
```

### List Containers as JSON

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

## Related Commands

* [`qovery application`](/cli/commands/application) - Manage applications
* [`qovery log`](/cli/commands/log) - View container logs
* [`qovery shell`](/cli/commands/shell) - Access container shell