Skip to content

Cronicle

Deploy Cronicle on Kubernetes using the soulteary/cronicle container image. Cronicle is a multi-server task scheduler and runner with a web-based UI for managing scheduled jobs, cron replacements, and automated workflows.

Key Features

  • Web UI — browser-based interface for creating and managing scheduled tasks
  • Multi-Server — optional UDP auto-discovery for distributed job execution
  • Job Storage — persistent storage for job data, history, and state
  • Email Notifications — configurable SMTP for job success/failure alerts
  • Session Encryption — auto-generated secret key for secure sessions
  • Concurrency Control — configurable maximum concurrent jobs per server

Installation

HTTPS repository:

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install cronicle helmforge/cronicle

OCI registry:

helm install cronicle oci://ghcr.io/helmforgedev/helm/cronicle

Basic Example

# values.yaml
cronicle:
  baseUrl: 'https://cronicle.example.com'
  maxJobs: 5
  emailFrom: '[email protected]'
  smtpHostname: 'smtp.example.com'

persistence:
  enabled: true
  size: 5Gi

ingress:
  enabled: true
  ingressClassName: traefik
  hosts:
    - host: cronicle.example.com
      paths:
        - path: /
          pathType: Prefix

Key Values

KeyDefaultDescription
cronicle.baseUrlhttp://localhost:3012Public base URL of the instance
cronicle.maxJobs0Maximum concurrent jobs (0 = unlimited)
cronicle.emailFromcronicle@localhostEmail sender address for notifications
cronicle.smtpHostnamelocalhostSMTP server hostname
secret.createtrueAuto-generate session encryption key
persistence.enabledtrueEnable persistent job storage
persistence.size5GiPVC size
ingress.enabledfalseEnable ingress

More Information