cronstable™ wiki

cronstable is an asyncio-based job scheduler for Linux, macOS, and Windows. Define jobs in YAML or load classic Vixie crontabs. It supports failure notifications, retries with exponential backoff, statsd and Prometheus metrics, and an optional HTTP control API with a web dashboard to monitor and control jobs.

An optional durable state store preserves run history across restarts and enables missed-run catch-up, job state, and DAG workflows. The MCP server lets AI agents inspect the daemon and, with control enabled, act on jobs and DAGs.

When one instance is not enough, opt-in clustering and leader election coordinates which replicas run scheduled jobs. Choose mTLS gossip or a lease backed by Kubernetes, etcd, or a shared filesystem. Execution guarantees depend on the backend and each job's cluster policy.

The daemon runs in the foreground, logs to stdout/stderr, and supports arbitrary time zones, which suits Docker, Kubernetes, and 12-factor deployments.

cronstable is a fork of gjcarneiro/yacron (by Gustavo Carneiro), continuing development from version 0.19.

Contents

Use the sidebar for the full index, or browse these sections:

• Getting Started: Installation · Command-Line Reference · Running on Windows · Windows Service · Windows MSI · Importing from Task Scheduler · Production and Container Deployment
• Configuration: Configuration Reference · Classic Crontabs · Schedules and Timezones · Business-Day Schedules · Schedule Linting · Hashed Schedules (H) · Commands and Environment · Environment-Variable Interpolation · Output Capturing · Includes, Defaults, and Multi-File Config · Logging Configuration
• Job Behavior: Concurrency and Timeouts · Resource Pools · Result Verification · Failure Detection and Retries · Pausing Jobs · Late-Run Detection (SLA) · Resource Monitoring · Durable State · Orchestration and DAGs · Workflow Recovery · Clustering and Leader Election · Job-Set ID
• Integrations: Reporting (Mail, Sentry, Shell, Webhook, Push, Event Log) · Push Notifications · Pairing from the Terminal · Windows Event Log · Metrics with Prometheus · Metrics with statsd · HTTP Control API · LAN Discovery (Bonjour/mDNS) · Listener TLS · Calendar Export (iCal) · Schedule Pressure · Duplicate Schedule Detection · Suggest a Slot · Why Didn't It Run? · Web Dashboard · Terminal Dashboard · MCP Server (Model Context Protocol)
• Reference and Development: Architecture and Internals · MCP Server Design · Release Pipeline · Performance Benchmarks · Troubleshooting and FAQ