Docs / Basics
What is Mapleloom?
Mapleloom is a background job runner that uses plain PostgreSQL as its queue, with retries, schedules and no extra infrastructure.
It is written in Rust and ships as a single binary for Linux, macOS and FreeBSD, on amd64 and arm64. Releases come out every few weeks; the changelog lists what changed.
Highlights
- Transactional enqueue. Jobs are rows. Insert one in the same transaction as your data and it exists exactly when the data does.
- Retries with backoff. Failed jobs are retried with exponential backoff and jitter, up to a limit you set per queue.
- Schedules. Run jobs on cron schedules. Only one worker enqueues each run, however many you start.
- Any language. Workers call your code over a small HTTP or stdin protocol, so jobs can be written in anything.
- Fast pickup. Workers use
LISTEN/NOTIFYto pick up new jobs within milliseconds, andSKIP LOCKEDto never collide. - Metrics. Queue depth, latency and failures as Prometheus metrics, ready for your dashboards.
Find your way
- Install Mapleloom on your machine or server.
- Follow the quick start to see it working in a few minutes.
- Look up every option in the configuration reference.
- Questions? The FAQ answers the common ones.