lukas-krecan/ShedLock

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

4211 stars · 570 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

ShedLock is a Java library that ensures scheduled tasks are executed at most once at the same time across multiple nodes by acquiring time-based locks in an external store. It supports many lock providers including JDBC databases, Mongo, Redis, ZooKeeper, Hazelcast, and various cloud stores.

Use cases

• prevent duplicate execution of scheduled tasks in a clustered app
• run cron jobs on multiple nodes but only once at a time
• distributed locking for Spring @Scheduled methods
• ensure a task runs on only one instance of a microservice
• coordinate background jobs across nodes using a database lock
• lock scheduled tasks with Redis or Mongo as the coordination store

When to choose

• you have scheduled tasks that must not run in parallel across nodes
• you use Spring, Micronaut, or plain Java and need a lightweight lock, not a full scheduler
• you already have a database, Redis, or other supported store for coordination

When to avoid

• you need a full distributed scheduler with queuing, retries, or job management - use db-scheduler or JobRunr
• your nodes' clocks are not synchronized, since locks are time-based
• you need tasks to wait for a lock rather than be skipped

Facets

library · maturity stable

scheduling concurrency middleware microservices backend developer-tools jvm distributed-lock scheduled-tasks java spring micronaut job-locking

Member repositories

For agents

markdown · JSON · MCP: product_card(name="lukas-krecan/ShedLock")