README.md

April 15, 2026 · View on GitHub

TickerQ

The modern job scheduler for .NET
Source-generated task scheduling with built-in persistence, cron & time-based execution, and real-time monitoring.

Why TickerQ?


Zero reflection, AOT ready	Source generators at compile time. No runtime reflection, no magic strings, fully trimmable.
Your database	EF Core (PostgreSQL, SQL Server, SQLite, MySQL) or Redis. No separate storage.
Real-time dashboard	Built-in SignalR dashboard. Monitor, inspect, manage — no paid add-ons.
Multi-node	Redis heartbeats, dead-node cleanup, lock-based coordination. Just add instances.
Minimal setup	`AddTickerQ()` → decorate a method → schedule. Minutes, not hours.

Features

Time & cron scheduling — one-off and recurring jobs
Source-generated — compile-time function registration for maximum performance
Dual persistence — EF Core (PostgreSQL, SQL Server, SQLite, MySQL) or Redis
Live dashboard — real-time UI with SignalR — screenshots
Retry & throttling — configurable retry policies with backoff
Dependency injection — first-class DI support
Multi-node — distributed coordination via Redis heartbeats and dead-node cleanup
Hub — centralized scheduling across applications via TickerQ Hub

Quick Start

dotnet add package TickerQ

1. Register services

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddTickerQ();

var app = builder.Build();
app.UseTickerQ();
app.Run();

2. Create a job

using TickerQ.Utilities.Base;

public class MyJobs
{
    [TickerFunction("HelloWorld")]
    public async Task HelloWorld(
        TickerFunctionContext context,
        CancellationToken cancellationToken)
    {
        Console.WriteLine($"Hello from TickerQ! Job ID: {context.Id}");
    }
}

3. Schedule it

public class MyService(ITimeTickerManager<TimeTickerEntity> manager)
{
    public async Task Schedule()
    {
        await manager.AddAsync(new TimeTickerEntity
        {
            Function = "HelloWorld",
            ExecutionTime = DateTime.UtcNow.AddSeconds(10)
        });
    }
}

Packages

Package	Description
`TickerQ`	Core scheduler engine
`TickerQ.Utilities`	Shared types, entities, and interfaces
`TickerQ.EntityFrameworkCore`	EF Core persistence provider
`TickerQ.Caching.StackExchangeRedis`	Redis persistence and distributed coordination
`TickerQ.Dashboard`	Real-time dashboard UI
`TickerQ.Instrumentation.OpenTelemetry`	OpenTelemetry tracing
`TickerQ.SourceGenerator`	Compile-time function registration

Note: All packages are versioned together. Always update all packages to the same version.

TickerQ Hub

Centralized scheduling across applications — hub.tickerq.net

Documentation

Full documentation at tickerq.net — docs are open-source at TickerQ-UI.

Sponsors & Backers

Support TickerQ through OpenCollective.

Contributing

PRs, ideas, and issues are welcome! Please read our Contributing Guide and sign the CLA before submitting a pull request.

Contributors

Thanks to all our wonderful contributors! See CONTRIBUTORS.md for details.