Skip to content

Install

The CLI (the reconciler) and the app SDK are installed independently. You typically need both: the CLI on your laptop or CI host, the SDK in the application that owns the schedules.

CLI (the reconciler)

macOS — Homebrew

Terminal window
brew install awbx/cronix/cronix

Or, if you’ll install more from this tap later:

Terminal window
brew tap awbx/cronix
brew install cronix

Linux / macOS — one-liner

Terminal window
curl -fsSL https://raw.githubusercontent.com/awbx/cronix/main/install.sh | sh

Pin a version + custom install dir:

Terminal window
curl -fsSL https://raw.githubusercontent.com/awbx/cronix/main/install.sh \
| CRONIX_VERSION=v0.7.2 INSTALL_DIR=/usr/local/bin sh

Linux packages (Debian/Ubuntu, RHEL/Fedora, Alpine)

Download from the latest GitHub release:

DistroFileInstall
Debian, Ubuntucronix_<ver>_linux_amd64.debsudo dpkg -i cronix_*.deb
RHEL, Fedora, openSUSEcronix_<ver>_linux_amd64.rpmsudo rpm -i cronix_*.rpm
Alpinecronix_<ver>_linux_amd64.apksudo apk add --allow-untrusted cronix_*.apk

Go developers

Terminal window
go install github.com/awbx/cronix/go/cmd/cronix@latest

Note: built without goreleaser’s -ldflags, so cronix version reports dev rather than the tagged version.

Docker

Terminal window
docker pull awbx/cronix

The Docker image is what the Kubernetes backend installs into your cluster’s CronJob pods.

Verify

Terminal window
cronix version

App SDK

TypeScript

Terminal window
pnpm add @awbx/cronix-sdk

For frameworks that don’t speak Web Fetch natively, install the matching sibling adapter:

Terminal window
pnpm add @awbx/cronix-adapter-express
pnpm add @awbx/cronix-adapter-fastify
pnpm add @awbx/cronix-adapter-koa
pnpm add @awbx/cronix-adapter-nest

Hono, Bun, Workers, Vercel/Next.js, and Deno serve a Web Request natively — no adapter needed.

Go

The Go module ships HMAC verification only — your app handles the schedule registration itself:

Terminal window
go get github.com/awbx/cronix/go/pkg/cronsdk

Future SDKs (Python, Ruby, …) will get their own packages; the spec/ directory is the cross-language correctness contract.