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