Ratchet: open-source distributed job scheduler for Java

RatchetInject one service. Submit a method reference.

Persistent background jobs, retries, and workflows for Jakarta EE, Quarkus, Spring Boot, and Micronaut.Persistent Java background jobs. Jakarta EE, Quarkus, Spring Boot, and Micronaut.

@Inject
JobSchedulerService scheduler;

scheduler
    .enqueue(() -> ship(orderId))
    .withMaxRetries(3)
    .submit();

@Inject JobSchedulerService scheduler; public void placeOrder(UUID orderId) { scheduler.enqueue(() -> orders.process(orderId)) .withMaxRetries(3) .withBackoff( BackoffPolicy.EXPONENTIAL, Duration.ofSeconds(2)) .withTags("orders", "fulfillment") .submit(); }

CDI-native API

Inject JobSchedulerService like any other bean and hand it a method reference. Ratchet persists it, claims it for one node at a time, retries on failure, and fires lifecycle events you can observe.

Resilience built in

Retries with fixed or exponential backoff, a circuit breaker for flaky downstreams, a dead-letter queue, and pause, resume, and cancel at runtime. It's part of the scheduler contract, not a library you bolt on.

Override any default

Every default is a bean you can replace. Encrypt payloads with your own KMS, or swap the cluster coordinator, retry policy, or store with a standard @Alternative. It's plain CDI, not a plugin system you have to learn.

Native-image jobs on Quarkus and Micronaut

The same persistent, retrying jobs run on Quarkus 3.20+ and on Micronaut 4.10 and 5, on the JVM and as a GraalVM native image, with SQL or MongoDB. Both integrations set up Ratchet's persistence and register its native metadata. On Quarkus, the extension also provisions a dev database.

Query and report

Read job and cluster state through a typed query service. Filter by principal, page large result sets, and build operational views without reaching into the store.

Spring Boot starters

Use Spring beans, application transactions, and Boot configuration. SQL and MongoDB starters target Boot 3.5 and 4.1 on Java 17 and 21, with Boot-controlled virtual threads on 21.

Try the Spring Boot quickstart