Quartz.Extensions.Redis

Quartz.Extensions.Redis

Quartz.Extensions.Redis provides a Redis-based distributed lock handler that replaces database row locks in clustered Quartz.NET setups.

Note: Quartz 3.18 or later required. Useful when the default database row locks cause deadlocks or contention on the QRTZ_LOCKS table under heavy scheduling load.

Installation

dotnet add package Quartz.Extensions.Redis

Usage

Job and trigger data stays in your relational database; only the locks move to Redis (SET NX PX):

var schedulerFactory = SchedulerBuilder.Create()
    .UsePersistentStore(store =>
    {
        store.UseSqlServer(connectionString);
        store.UseSystemTextJsonSerializer();
        store.UseClustering();
        store.UseRedisLockHandler(redis =>
        {
            redis.RedisConfiguration = "redis-server:6379";
        });
    })
    .Build();

Documentation

📖 Full documentation, including property-based configuration and design details: https://www.quartz-scheduler.net/documentation/quartz-3.x/packages/redis.html