Configuration

Core options

Pass options to AddSurefire to tune runtime behavior:

builder.Services.AddSurefire(options =>
{
    options.PollingInterval = TimeSpan.FromSeconds(5);
    options.ShutdownTimeout = TimeSpan.FromSeconds(30);
    options.RetentionPeriod = TimeSpan.FromDays(14);
    options.MaxNodeConcurrency = 16;
});

Option	Default	Description
NodeName	{MachineName}:{ProcessId}:{random}	Name reported in node views and logs. Must be unique per process
PollingInterval	5s	Fallback polling interval when notifications are not available, and the primary wakeup signal for SQL Server and SQLite
HeartbeatInterval	30s	Node heartbeat interval
InactiveThreshold	2min	Inactivity window used for node/run recovery decisions
RetentionPeriod	7 days	How long completed runs are kept. Set to null to disable purge
RetentionCheckInterval	5min	How often retention cleanup runs
ShutdownTimeout	15s	Time allowed for in-flight runs during host shutdown
MaxNodeConcurrency	min(ProcessorCount * 5, 20)	Maximum concurrent executions on this node. Set to null for unlimited
AutoMigrate	true	Runs store migrations at startup
SerializerOptions	camelCase, case-insensitive, numbers from strings	JSON options for job arguments and results

Health checks

AddSurefire registers a health check named surefire. To expose it:

app.MapHealthChecks("/health");

Dashboard

Map the dashboard with app.MapSurefireDashboard(). See Dashboard for setup, authorization, and the REST API.