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

> Cronjob management commands

## Overview

Manage cronjobs within your Qovery environment. Cronjobs run on a scheduled basis (similar to cron in Unix/Linux).

## Commands

### List Cronjobs

List all cronjobs in current environment:

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

**Flags:**

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

### Deploy Cronjob

Deploy a cronjob:

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

Deploy multiple cronjobs at once:

```bash theme={null}
qovery cronjob deploy --cronjobs "cron1,cron2"
```

Deploy with a specific commit ID or image tag:

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

**Flags:**

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

### Redeploy Cronjob

Redeploy an existing cronjob with the same configuration:

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

### Stop Cronjob

Stop a cronjob:

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

### Delete Cronjob

Delete a cronjob:

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

### Cancel Deployment

Cancel a cronjob deployment:

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

**Flags:**

| Flag             | Short | Description             |
| ---------------- | ----- | ----------------------- |
| `--cronjob`      | `-n`  | Cronjob Name (required) |
| `--organization` |       | Organization Name       |
| `--project`      |       | Project Name            |
| `--environment`  |       | Environment Name        |

### Update Cronjob

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

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

# Update image tag (for image-based cronjobs)
qovery cronjob update --cronjob "my-cron" --tag "v2.0.0"

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

**Flags:**

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

### Clone Cronjob

Clone a cronjob to another environment or project:

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

**Flags:**

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

## Examples

### Deploy Cronjob

```bash theme={null}
# List cronjobs
qovery cronjob list

# Deploy cronjob
qovery cronjob deploy --cronjob "backup-job"

# Deploy and watch status
qovery cronjob deploy --cronjob "backup-job" --watch
```

### Update Cronjob and Redeploy

```bash theme={null}
# Update branch for a git-based cronjob
qovery cronjob update --cronjob "backup-job" --branch "feature/new-schedule"

# Redeploy to apply changes
qovery cronjob redeploy --cronjob "backup-job"
```

### Deploy Cronjob with Specific Tag

```bash theme={null}
qovery cronjob deploy --cronjob "backup-job" --tag "v2.1.0"
```

### List Cronjobs as JSON

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

## Related Commands

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