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
brew install awbx/cronix/cronixOr, if you’ll install more from this tap later:
brew tap awbx/cronixbrew install cronixLinux / macOS — one-liner
curl -fsSL https://raw.githubusercontent.com/awbx/cronix/main/install.sh | shPin a version + custom install dir:
curl -fsSL https://raw.githubusercontent.com/awbx/cronix/main/install.sh \ | CRONIX_VERSION=v0.7.2 INSTALL_DIR=/usr/local/bin shLinux packages (Debian/Ubuntu, RHEL/Fedora, Alpine)
Download from the latest GitHub release:
| Distro | File | Install |
|---|---|---|
| Debian, Ubuntu | cronix_<ver>_linux_amd64.deb | sudo dpkg -i cronix_*.deb |
| RHEL, Fedora, openSUSE | cronix_<ver>_linux_amd64.rpm | sudo rpm -i cronix_*.rpm |
| Alpine | cronix_<ver>_linux_amd64.apk | sudo apk add --allow-untrusted cronix_*.apk |
Go developers
go install github.com/awbx/cronix/go/cmd/cronix@latestNote: built without goreleaser’s -ldflags, so cronix version reports dev rather than the tagged version.
Docker
docker pull awbx/cronixThe Docker image is what the Kubernetes backend installs into your cluster’s CronJob pods.
Verify
cronix versionApp SDK
TypeScript
pnpm add @awbx/cronix-sdkFor frameworks that don’t speak Web Fetch natively, install the matching sibling adapter:
pnpm add @awbx/cronix-adapter-expresspnpm add @awbx/cronix-adapter-fastifypnpm add @awbx/cronix-adapter-koapnpm add @awbx/cronix-adapter-nestHono, 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:
go get github.com/awbx/cronix/go/pkg/cronsdkFuture SDKs (Python, Ruby, …) will get their own packages; the spec/ directory is the cross-language correctness contract.