Croniq

Distributed cron that just works.

Single binary. SQLite default. Production-ready retries. MCP-ready.

docker run -p 4000:4000 ghcr.io/nuetzliches/croniq

How it works

Deploy once, define in code, execute everywhere — no external dependencies.

1

Deploy

One binary, zero setup. SQLite is embedded — you're in production in seconds. Swap to Postgres when you're ready to scale.

docker run -p 4000:4000 ghcr.io/nuetzliches/croniq
2

Define

Write a Croniqfile: human-readable schedules, retry policies, business-day calendars, and capability routing. Track it in git like any config.

croniq validate Croniqfile
3

Execute

Runners poll for work via HTTP long-poll — no inbound ports, no firewall rules. Scale runners independently from the scheduler.

croniq-demo-runner

See it in action

From zero to running jobs in one command — no config files needed.

Built for reliability

Everything you need to replace fragile crontabs with something you can actually trust.

Single Binary

One Docker pull or cargo install. No JVM, no cluster, no dependencies. SQLite embedded by default, Postgres when you scale.

Retries + Dead Letter

Exponential, linear, or fixed backoff with jitter. Failed jobs land in a dead letter queue for inspection and one-click replay.

Croniqfile DSL

Human-readable scheduling config. Validate, format, compile, and migrate from existing crontabs. Infrastructure as code for your schedules.

Pull-Based Runners

Runners poll for work via HTTP long-poll. Scale independently. Built-in capability routing and lease management.

React Dashboard

Jobs, runners, executions, dead letters. Live status via SSE, log viewer, and scheduling controls out of the box.

MCP Server

31 tools for AI assistant integration. Manage jobs, observe queues, trigger runs from Claude, Cursor, or any MCP client.

Schedules as code

Define jobs, calendars, and retry policies in a human-readable config file.

defaults {
  timezone Europe/Vienna
  retry exponential { max_attempts 3; base 2s; cap 30s }
  timeout 5m
}

calendar business-days {
  include weekly monday tuesday wednesday thursday friday
  exclude annual 01-01 12-25 12-26
}

job billing:invoice {
  every weekday at 02:00 { calendar business-days }
  runner { require billing }
  timeout 15m
}

job etl:sync {
  every 15 minutes
}

Generate a Croniqfile from your existing crontabs using the web DSL generator.

Up and running in 60 seconds

Choose your preferred install method. The CLI is free and open source (MIT / Apache-2.0).

No toolchain required · CI-ready
# Start the scheduler — dashboard opens at http://localhost:4000
docker run -p 4000:4000 ghcr.io/nuetzliches/croniq
Image at ghcr.io/nuetzliches/croniq. Builds for linux/amd64 and linux/arm64.
macOS · Linux
# Add the tap once, then install.
brew tap nuetzliches/tap
brew install croniq

# One-time setup (creates Croniqfile + admin user)
croniq quickstart

# Start the scheduler
croniq-server
Formula at nuetzliches/homebrew-tap — auto-bumped by the release workflow.
Rust toolchain required
# Installs croniq, croniq-server, and croniq-mcp.
cargo install croniq

# One-time setup (creates Croniqfile + admin user)
croniq quickstart

# Start the scheduler
croniq-server
No Rust? rustup.rs gets you set up in 60 seconds.
macOS · Linux · pre-built binary
# Downloads the pre-built binary for your platform.
curl -fsSL https://raw.githubusercontent.com/nuetzliches/croniq/main/install.sh | sh

# One-time setup (creates Croniqfile + admin user)
croniq quickstart

# Start the scheduler
croniq-server
Installs croniq, croniq-server, and croniq-mcp to /usr/local/bin. Script at install.sh.

Dashboard opens at http://localhost:4000 after croniq-server.

Who it's for

Teams tired of cron-at-scale being a solved-but-still-painful problem.

Backend engineers Replacing systemd timers or Celery beat. Want retries, visibility, and something that doesn't fall over at 03:00.
Platform teams Need a shared job scheduler across services. Croniq runs standalone, exposes an OpenAPI, and fits any stack.
AI-native teams Using MCP clients like Claude or Cursor? The built-in MCP server exposes 31 tools for agent-driven scheduling.