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

> Lifecycle job management commands

## Overview

Manage lifecycle jobs within your Qovery environment. Lifecycle jobs run at specific points in your environment lifecycle (e.g., before/after deployment, on start, on stop, on delete).

## Commands

### List Lifecycle Jobs

List all lifecycle jobs in current environment:

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

### Deploy Lifecycle Job

Deploy a lifecycle job:

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

Deploy multiple lifecycle jobs at once:

```bash theme={null}
qovery lifecycle deploy --lifecycles "lifecycle1,lifecycle2"
```

Deploy with a specific commit ID or image tag:

```bash theme={null}
qovery lifecycle deploy --lifecycle "my-lifecycle" --commit-id "abc123"
qovery lifecycle deploy --lifecycle "my-lifecycle" --tag "v1.2.0"
```

**Flags:**

| Flag | Short | Description |
| - | - | - |
| `--lifecycle` | `-n` | Lifecycle Job Name |
| `--lifecycles` | | Lifecycle Job Names (comma separated) |
| `--commit-id` | `-c` | Lifecycle Commit ID |
| `--tag` | `-t` | Lifecycle Tag |
| `--watch` | `-w` | Watch lifecycle status until it's ready or an error occurs |
| `--organization` | | Organization Name |
| `--project` | | Project Name |
| `--environment` | | Environment Name |

### Redeploy Lifecycle Job

Redeploy an existing lifecycle job with the same configuration:

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

### Stop Lifecycle Job

Stop a lifecycle job:

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

### Delete Lifecycle Job

Delete a lifecycle job:

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

### Cancel Deployment

Cancel a lifecycle job deployment:

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

### Update Lifecycle Job

Update lifecycle job source configuration (branch, tag, or image name):

```bash theme={null}
# Update git branch (for Dockerfile-based lifecycle jobs)
qovery lifecycle update --lifecycle "my-lifecycle" --branch "main"

# Update image tag (for image-based lifecycle jobs)
qovery lifecycle update --lifecycle "my-lifecycle" --tag "v2.0.0"

# Update image name
qovery lifecycle update --lifecycle "my-lifecycle" --image-name "my-registry/my-image"
```

**Flags:**

| Flag | Short | Description |
| - | - | - |
| `--lifecycle` | `-n` | Lifecycle Name (required) |
| `--branch` | `-b` | Lifecycle Branch (for Dockerfile-based lifecycle jobs) |
| `--tag` | `-t` | Lifecycle Tag (for image-based lifecycle jobs) |
| `--image-name` | | Lifecycle Image Name (for image-based lifecycle jobs) |
| `--organization` | | Organization Name |
| `--project` | | Project Name |
| `--environment` | | Environment Name |

### Clone Lifecycle Job

Clone a lifecycle job to another environment or project:

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

**Flags:**

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

## Examples

### Deploy Database Migration Job

```bash theme={null}
# List lifecycle jobs
qovery lifecycle list

# Deploy migration job
qovery lifecycle deploy --lifecycle "db-migration"

# Deploy and watch status
qovery lifecycle deploy --lifecycle "db-migration" --watch
```

### Update Lifecycle Job and Redeploy

```bash theme={null}
# Update branch for a git-based lifecycle job
qovery lifecycle update --lifecycle "db-migration" --branch "feature/new-migration"

# Redeploy to apply changes
qovery lifecycle redeploy --lifecycle "db-migration"
```

### Run Post-Deployment Script with Specific Tag

```bash theme={null}
qovery lifecycle deploy --lifecycle "post-deploy-script" --tag "v1.5.0"
```

## Lifecycle Job Types

| Event | Description |
| - | - |
| **START** | Runs when environment starts |
| **STOP** | Runs when environment stops |
| **DELETE** | Runs before environment deletion |
| **DEPLOY** | Runs during deployment |

## Related Commands

* [`qovery cronjob`](/cli/commands/cronjob) - Manage scheduled cronjobs
* [`qovery log`](/cli/commands/log) - View lifecycle job logs
* [`qovery status`](/cli/commands/status) - Check lifecycle job status