Skip to main content

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:
qovery cronjob list
Flags:
FlagDescription
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name
--jsonJSON output

Deploy Cronjob

Deploy a cronjob:
qovery cronjob deploy --cronjob "my-cron"
Deploy multiple cronjobs at once:
qovery cronjob deploy --cronjobs "cron1,cron2"
Deploy with a specific commit ID or image tag:
qovery cronjob deploy --cronjob "my-cron" --commit-id "abc123"
qovery cronjob deploy --cronjob "my-cron" --tag "v1.2.0"
Flags:
FlagShortDescription
--cronjob-nCronjob Name
--cronjobsCronjob Names (comma separated)
--commit-id-cCronjob Commit ID
--tag-tCronjob Tag
--watch-wWatch cronjob status until it’s ready or an error occurs
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Redeploy Cronjob

Redeploy an existing cronjob with the same configuration:
qovery cronjob redeploy --cronjob "my-cron"

Stop Cronjob

Stop a cronjob:
qovery cronjob stop --cronjob "my-cron"

Delete Cronjob

Delete a cronjob:
qovery cronjob delete --cronjob "my-cron"

Cancel Deployment

Cancel a cronjob deployment:
qovery cronjob cancel --cronjob "my-cron"
Flags:
FlagShortDescription
--cronjob-nCronjob Name (required)
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Update Cronjob

Update cronjob source configuration (branch, tag, or image name):
# 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:
FlagShortDescription
--cronjob-nCronjob Name (required)
--branch-bCronjob Branch (for Dockerfile-based cronjobs)
--tag-tCronjob Tag (for image-based cronjobs)
--image-nameCronjob Image Name (for image-based cronjobs)
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Clone Cronjob

Clone a cronjob to another environment or project:
qovery cronjob clone --cronjob "my-cron"
Flags:
FlagShortDescription
--cronjob-nCronjob Name (required)
--target-projectTarget Project Name
--target-environmentTarget Environment Name
--target-cronjob-nameTarget Cronjob Name
--organizationOrganization Name
--projectProject Name
--environmentEnvironment Name

Examples

Deploy Cronjob

# 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

# 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

qovery cronjob deploy --cronjob "backup-job" --tag "v2.1.0"

List Cronjobs as JSON

qovery cronjob list --json