Hangfire 1.8.6

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package Hangfire --version 1.8.6
NuGet\Install-Package Hangfire -Version 1.8.6
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Hangfire" Version="1.8.6" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Hangfire --version 1.8.6
#r "nuget: Hangfire, 1.8.6"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Hangfire as a Cake Addin
#addin nuget:?package=Hangfire&version=1.8.6

// Install Hangfire as a Cake Tool
#tool nuget:?package=Hangfire&version=1.8.6

An easy and reliable way to perform fire-and-forget, delayed and recurring, long-running, short-running, CPU or I/O intensive tasks inside ASP.NET applications. No Windows Service / Task Scheduler required. Even ASP.NET is not required.
Backed by Redis, SQL Server, SQL Azure or MSMQ. This is a .NET alternative to Sidekiq, Resque and Celery.
https://www.hangfire.io/

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages (188)

Showing the top 5 NuGet packages that depend on Hangfire:

Package Downloads
VirtoCommerce.Platform.Hangfire The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Virto Commerce is a flexible B2B ecommerce solution that offers powerful tools for enterprise business users. https://virtocommerce.com

N3O.Umbraco.Scheduler

TODO

ImmediaC.SimpleCms

ASP.NET Core based CMS

ComplianceAuditSystems.AcabimCommonServices

Package Description

Bnsights.Mvc

Bnsights.Mvc is RAD Helper DLL for MVC Projects in Bnsights DMCC. Also known as Bnsights Business Solutions Framework (BBSF).

GitHub repositories (20)

Showing the top 5 popular GitHub repositories that depend on Hangfire:

Repository Stars
elsa-workflows/elsa-core
A .NET workflows library
Kareadita/Kavita
Kavita is a fast, feature rich, cross platform reading server. Built with the goal of being a full solution for all your reading needs. Setup your own server and share your reading collection with your friends and family.
fullstackhero/dotnet-webapi-starter-kit
production grade .net 8 webapi starter kit with multitenancy support and clean code. 🔥
fullstackhero/blazor-starter-kit
Clean Architecture Template for Blazor WebAssembly Built with MudBlazor Components.
dotnetcore/osharp
OSharp是一个基于.Net6.0的快速开发框架,框架对 AspNetCore 的配置、依赖注入、日志、缓存、实体框架、Mvc(WebApi)、身份认证、功能权限、数据权限等模块进行更高一级的自动化封装,并规范了一套业务实现的代码结构与操作流程,使 .Net 框架更易于应用到实际项目开发中。
Version Downloads Last updated
1.8.11 11,700 2/23/2024
1.8.10 49,964 2/12/2024
1.8.9 118,279 1/24/2024
1.8.7 191,549 12/29/2023
1.8.6 649,390 10/18/2023
1.8.5 737,329 8/11/2023
1.8.4 164,820 7/27/2023
1.8.3 385,462 6/27/2023
1.8.2 411,993 5/26/2023
1.8.1 115,731 5/18/2023
1.8.0 265,705 4/28/2023
1.7.36 62,100 6/29/2023
1.7.35 18,469 5/18/2023
1.7.34 456,533 3/30/2023
1.7.33 986,813 1/31/2023
1.7.32 1,049,388 11/21/2022
1.7.31 1,800,671 8/19/2022
1.7.30 1,295,712 6/10/2022
1.7.29 298,483 5/23/2022
1.7.28 3,036,398 12/18/2021
1.7.27 932,248 11/3/2021
1.7.26 139,764 10/27/2021
1.7.25 1,083,004 8/30/2021
1.7.24 1,109,552 6/28/2021
1.7.23 635,201 5/28/2021
1.7.22 820,282 4/13/2021
1.7.21 14,446 4/12/2021
1.7.20 367,802 3/19/2021
1.7.19 1,335,815 1/15/2021
1.7.18 1,034,223 11/20/2020
1.7.17 531,841 10/20/2020
1.7.16 116,828 10/14/2020
1.7.15 72,625 10/8/2020
1.7.14 542,463 9/24/2020
1.7.13 140,073 9/15/2020
1.7.12 787,759 7/24/2020
1.7.11 2,256,898 4/15/2020
1.7.10 276,452 4/2/2020
1.7.9 2,089,010 1/20/2020
1.7.8 714,602 12/5/2019
1.7.7 787,007 10/22/2019
1.7.6 1,453,827 8/5/2019
1.7.5 320,958 7/18/2019
1.7.4 324,565 6/28/2019
1.7.3 626,201 5/23/2019
1.7.2 419,614 4/29/2019
1.7.1 393,647 4/16/2019
1.7.0 342,989 3/29/2019
1.6.30 28,049 4/29/2021
1.6.29 53,948 4/15/2020
1.6.28 75,771 1/14/2020
1.6.27 60,578 6/27/2019
1.6.26 74,925 5/23/2019
1.6.25 21,280 4/9/2019
1.6.24 114,684 3/27/2019
1.6.23 202,324 3/13/2019
1.6.22 643,507 1/25/2019
1.6.21 1,094,208 11/1/2018
1.6.20 1,081,762 7/31/2018
1.6.19 1,237,021 4/6/2018
1.6.18 27,309 4/5/2018
1.6.17 1,517,528 9/19/2017
1.6.16 158,177 9/2/2017
1.6.15 239,912 8/8/2017
1.6.14 289,898 6/16/2017
1.6.13 61,182 6/7/2017
1.6.12 546,490 3/22/2017
1.6.11 38,988 3/14/2017
1.6.10 11,080 3/13/2017
1.6.9 47,860 3/2/2017
1.6.8 350,299 12/21/2016
1.6.7 185,501 11/25/2016
1.6.6 171,449 10/13/2016
1.6.5 98,863 9/24/2016
1.6.4 78,357 8/30/2016
1.6.3 39,760 8/19/2016
1.6.2 48,273 8/5/2016
1.6.1 55,962 7/27/2016
1.6.0 33,779 7/15/2016
1.5.9 134,084 7/11/2016
1.5.8 47,335 6/17/2016
1.5.7 22,123 5/30/2016
1.5.6 60,814 4/22/2016
1.5.5 20,599 4/14/2016
1.5.4 46,355 3/22/2016
1.5.3 300,586 11/6/2015
1.5.2 25,407 10/15/2015
1.5.1 6,408 10/14/2015
1.5.0 54,391 10/1/2015
1.4.7 6,073 10/1/2015
1.4.6 26,414 8/29/2015
1.4.5 34,013 7/24/2015
1.4.4 5,400 7/23/2015
1.4.3 61,653 5/27/2015
1.4.2 13,465 5/6/2015
1.4.1 33,733 4/14/2015
1.3.4 58,849 2/4/2015
1.3.3 8,221 1/28/2015
1.3.2 5,725 1/27/2015
1.3.1 11,039 1/13/2015
1.3.0 11,585 12/10/2014
1.2.2 13,390 11/24/2014
1.2.1 5,193 11/22/2014
1.2.0 8,264 11/17/2014
1.1.1 26,087 9/5/2014
1.1.0 6,461 9/3/2014
1.0.2 9,222 7/1/2014
1.0.1 5,232 6/30/2014
1.0.0 5,644 6/30/2014
0.9.1 5,405 6/12/2014
0.9.0 4,036 6/7/2014
0.8.3 4,365 5/23/2014
0.8.2 3,991 5/21/2014
0.8.1 4,088 5/17/2014
0.8.0 5,058 5/2/2014
0.7.5 4,865 4/10/2014
0.7.4 4,066 4/7/2014
0.7.3 3,780 4/4/2014
0.7.2 4,012 4/4/2014
0.7.1 4,443 4/1/2014
0.7.0 4,228 3/22/2014
0.6.2 3,051 1/28/2014
0.6.1 3,011 1/27/2014
0.6.0 3,022 1/27/2014
0.5.2 3,004 11/19/2013
0.5.1 3,047 11/12/2013
0.5.0 4,454 11/10/2013

Release notes are available in our blog https://www.hangfire.io/blog/
Please see https://docs.hangfire.io/en/latest/upgrade-guides/upgrading-to-hangfire-1.8.html to learn how to upgrade.

1.8.6

• Changed – Update jQuery library in Dashboard UI to version 3.7.1.
• Changed – Mark all types in Hangfire.Annotations with `EditorBrowsableAttribute(Never)`.
• Changed – Change state card colors for the Awaiting state to match the Scheduled state.
• Fixed – Exception when deserializing an instance of the `AutomaticRetryAttribute` class from JSON.
• Fixed – Add serialization-related constructors for all the exception classes.
• Fixed – Use invariant culture or ordinal comparisons for internal strings.
• Fixed – Use invariant culture when formatting key names for metrics.
• Fixed – Use `CurrentCulture` instead of `CurrentUICulture` when displaying time.
• Project – Enable running static analysis by Coverity Scan weekly.
• Project – Enable mandatory static analysis by the Microsoft.CodeAnalysis.NetAnalyzers package.
• Project – Change MSBuild path when building using newer .NET SDKs for Razor views.
       
Hangfire.SqlServer

• Fixed – Exception in Dashboard UI when schema version is not present in a database.
• Fixed – `DbCommand` resource leak when releasing a lock detected by static analysis.
• Fixed – Don't add SQL Server-related metrics multiple times in Dashboard UI.

Hangfire.NetCore

• Fixed – Include assembly information to the Hangfire.NetCore assembly.

1.8.5

Hangfire.Core

• Added – Possibility to inform a `FaviconPath` on `DashboardOptions` (by @cezar-pimentel).
• Fixed – Inability to restore a disabled recurring job, regression in version 1.8.3.
• Fixed – Make it possible to serialize the `AutomaticRetryAttribute` filter to JSON.

Hangfire.SqlServer

• Fixed – "Query processor could not produce a query plan" when removing expired counters in `Schema 5`.

1.8.4

Hangfire.Core

• Added – Pass server id from a worker to the `PerformContext.ServerId` property available in filters.
• Fixed – Send heartbeats until full background processing server shutdown.
     
Hangfire.NetCore

• Changed – Send the stop signal earlier in the shutdown pipeline when hosting in .NET Core 3.1 or higher.
• Changed – Set processing server to null in hosted service to avoid `ObjectDisposedException`.
• Fixed – Other `IHostedService` implementations can block Hangfire server from being stopped.

1.8.3

Hangfire.Core

• Changed – Allow to configure `MaxLinesInStackTrace` for a particular `FailedState` instance.
• Fixed – Remove job id from schedule when it's not in the Scheduled state for some reason.
• Fixed – Missing invocations of recurring jobs when the new "Ignorable" option is used.
• Fixed – Make `DisableConcurrentExecutionAttribute` and `LatencyTimeoutAttribute` serializable.

1.8.2

Hangfire.Core

• Changed – Disable transactional job creation feature appeared in 1.8.0.
• Fixed – "Can not start continuation XXX" error when storage supports transactional job creation.

Hangfire.SqlServer

• Fixed – `InvalidOperationException` with new dashboard metrics when a database has multiple data/log files.

1.8.1
     
Hangfire.Core

• Added – `MisfireHandlingMode.Ignorable` to avoid scheduling recurring jobs on missed schedules.
• Added – Support disabling dark mode via the `DashboardOptions.DarkModeEnabled` property.
• Changed – Remove the 1-hour limitation for the `WithJobExpirationTimeout` configuration method.
• Fixed – Add missing `UseDefaultCulture` configuration method overloads.
• Fixed – Add missing `UseDashboardStylesheet` and `UseJobDetailsRenderer` configuration methods.
• Fixed – Give even more space for identifiers on the Recurring Jobs page.
• Fixed – `state-card-state-active` color is not very dark (by @coolhome).
• Fixed – Slightly change chart proportions to fit 4K in Dashboard UI.

Hangfire.SqlServer

• Fixed – Blocked workers regression since 1.7.33 when using multiple servers inside a process.
• Fixed – Target schema version is less than the current schema version error.
• Fixed – Implement database metrics without the need for additional permissions.
• Fixed – Use the `forceseek` table hint whenever possible to avoid performance drops.
     
Hangfire.NetCore

• Fixed – Add `net461` target for Hangfire.NetCore package to avoid missing method exceptions.

1.8.0

Hangfire.Core

• Breaking – Dropped the `NET45` platform target in favor of the `NET451` target to support Visual Studio 2022.

• Added – Introduce the `Job.Queue` property, so jobs now can have their own queue specified.
• Added – Method overloads to create background jobs directly with a custom default queue.
• Added – Method overloads to create recurring jobs directly with a custom default queue.
• Added – `IBackgroundJobClient.Create` method overloads with the new `queue` parameter.
• Added – Allow to filter exception types in `AutomaticRetryAttribute` by using the new `OnlyOn` property.
• Added – `DeletedState` now has the persisted `Exception` property populated after a failure.
• Added – `JobContinuationOptions.OnlyOnDeletedState` to create continuations after a failure.
• Added – `Exception` job parameter is passed to continuation when `UseResultsInContinuations` method is used.
• Added – `FromExceptionAttribute` to deal with an antecedent exception in a background job continuation.
• Added – Make it possible to specify multiple `JobContinuationOptions` values for a continuation.
• Added – `BackgroundJobServerOptions.IsLightweightServer` option to run a server with no storage processes.
• Added – Ability to use custom formattable resource identifiers for the `DisableConcurrentExecution` filter.
• Added – Pass `ServerId` to `FailedState` instances to simplify the debugging on different servers.
• Added – Allow to pass job parameters when creating a job (by @brian-knoll-micronetonline).
• Added – `MisfireHandlingMode.Strict` to create a job for each missed recurring job occurrence.
• Added – Support for default culture and UI culture via the `UseDefaultCulture` configuration method.
• Added – Introduce the `captureDefault` parameter in the `CaptureCulture` filter.
• Added – `IGlobalConfiguration.UseFilterProvider` extension method to unify the configuration.
• Added – Built-in `Remove` method for `JobFilterCollection` to remove global filters based on their type.
• Added – `CompatibilityLevel.Version_180` flag to avoid storing culture parameters when they are the same as the default ones.
• Changed – Create job atomically when `Transaction.CreateJob` feature is supported by the storage.
• Changed – Query time from storage in recurring and delayed schedulers when supported by storage.
• Changed – Move job to the `DeletedState` instead of `SucceededState` when its invocation was canceled by a filter.
• Changed – Speedup delayed jobs when a custom default queue is specified by avoiding extra state transition.
• Changed – Use UI culture from `CurrentCulture` parameter when `CurrentUICulture` one is missing.
• Changed – Increase the default value for the `BackgroundJobServerOptions.StopTimeout` to 500 ms.
• Deprecated – `AddOrUpdate` overloads with optional params defined in the `RecurringJobManagerExtensions` class.
• Deprecated – `AddOrUpdate` overloads with optional parameters defined in the `RecurringJob` class.
• Deprecated – `AddOrUpdate` method overloads with no `recurringJobId` parameter.
• Deprecated – `RecurringJobOptions.QueueName` property, new methods should be used instead.
• Breaking – Dropped `NET45` platform target in favor of `NET451` target to support Visual Studio 2022.

Dashboard UI
• Added – Dark mode support for Dashboard UI depending on the system settings (by @danillewin).
• Added – Dashboard UI now has a full-width layout to display more data (by @danillewin).
• Added – Allow to add custom JavaScript and CSS files to the Dashboard UI via the `DashboardRoutes` class.
• Added – `DefaultRecordsPerPage` property on the `DashboardOptions` class (by @PaulARoy).
• Added – `IGlobalConfiguration.UseJobDetailsRenderer` method for custom renderers for the Job Details page.
• Added – Display deleted jobs in the Realtime and History graphs when supported by storage.
• Added – `IGlobalConfiguration.UseDashboardMetrics` extension method to pass multiple metrics at once.
• Added – State renderer for the `DeletedState` to display its new exception property.
• Added – Support for new `MonitoringApi` methods for the Awaiting Jobs page.
• Changed – Make it possible to display methods of non-loaded jobs in the Dashboard UI when supported by storage.
• Changed – Improved display of realtime chart with more accents on failed and deleted jobs.
• Changed – Don't display the queue name in the state transition list when it's the `default` one.
• Changed – Display scheduled job count when the enqueued count is zero on the main metric.

Extensibility
• Added – `Factory`, `StateMachine`, and `Performer` properties to context classes to avoid injecting services.
• Added – Allow to pass custom data to `ApplyStateContext` and `ElectStateContext` instances.
• Added – Preserve custom data dictionary between the entire filter chain.
• Added – Allow to pass a transaction to background job state changer when new methods are implemented.
• Changed – Ignore some members when serializing a `JobFilterAttribute` instance to decrease the payload size.

Storage
• Added – Virtual `JobStorage.GetReadOnlyConnection` method intended to return `JobStorageConnection` for replicas.
• Added – Virtual `JobStorage.HasFeature` method for querying optional features.
• Added – The `JobStorageFeatures` class to avoid using magic strings in storage features.
• Added – Optional `GetSetCount`, `GetSetContains`, and `GetUtcDateTime` methods for the `JobStorageConnection` class.
• Added – Optional `AcquireDistributedLock` and `RemoveFromQueue` methods for the `JobStorageTransaction` class.
• Added – Optional `CreateJob` and `SetJobParameter` methods for the `JobStorageTransaction` class.
• Added – Optional `ParametersSnapshot` property for `BackgroundJob` and `JobData` classes to minimize roundtrips in the future.
• Added – Support for transactional acknowledgment using a new storage method for better handling some data loss scenarios.
• Added – Fetch `Retries` and `Awaiting` metrics in `StatisticsDto` properties when supported by storage.
• Added – The `JobStorageMonitor` class with more available methods for the new features.
• Changed – Allow to query job parameters without additional roundtrip when supported by storage.
• Changed – Expose state data dictionaries in list DTOs when supported by storage.
• Changed – Rely on storage indexing with the `Monitoring.AwaitingJobs` feature.

Internals
• Added – `IBackgroundProcess.UseBackgroundPool` now allows to pass thread configuration logic.
• Added – `BackgroundJobServerOptions.WorkerThreadConfigurationAction` option for custom thread configuration.
• Changed – Allow changing queues on the fly with custom worker configuration.
• Changed – Avoid storage roundtrip to query job data in worker, take data from previous state change.
• Changed – `FromParameterAttribute`-based logic now always overwrites arguments, even with non-null values.
• Changed – Turn the `JobContinuationOptions` enum into flags while still possible.
• Changed – Re-implement `TaskExtensions.WaitOneAsync` only with the `RegisterWaitForSingleObject` method.
• Changed – `ServerHeartbeatProcess` now uses `ThreadPriority.AboveNormal` to prioritize heartbeats.

Hangfire.NetCore

• Added – `IApplicationBuilder.UseHangfireServer` that accepts custom factory for `IBackgroundProcessingServer`.
• Added – `net451` and `netstandard1.3` targets for the package.
• Changed – Use `netstandard2.1` target instead of `netcoreapp3.0` for the package.
• Changed – Send the "stop" signal earlier when the host supports .NET Standard 2.1.
• Changed – Don't throw `ObjectDisposedException` when hosted service is disposed twice.

Hangfire.AspNetCore

• Breaking – Make the package to be dependent on Hangfire.NetCore and use the same types.
• Added – `IApplicationBuilder.UseHangfireServer` that accepts custom factory for `IBackgroundProcessingServer`.

Hangfire.SqlServer

• Breaking – Prioritise Microsoft.Data.SqlClient package over System.Data.SqlClient one.
• Breaking – Dropped the `NET45` platform target in favor of the `NET451` target to support Visual Studio 2022.

• Added – `Schema 8` migration with fixed `JobQueue.Id` column to use the `bigint` type.
• Added – `Schema 9` migration that creates an index for the `State.CreatedAt` column.
• Added – Automatic client package detection based on available types, preferring `System.Data.SqlClient` (by @0xced).
• Added – `SqlServerStorageOptions.DbProviderFactory` option to use a custom provider factory.
• Added – Clean up of old state entries of a non-finished job when `InactiveStateExpirationTimeout` is set.
• Added – `TryAutoDetectSchemaDependentOptions` option to automatically enable options based on the schema.
• Added – Optional experimental transactional acknowledge for SQL Server (`UseTransactionalAcknowledge` option).
• Added – Implement the `Connection.GetUtcDateTime` feature to make work the new changes in schedulers.
• Added – `SqlServerStorage.SchemaVersion` metric for Dashboard UI.
• Added – `DefaultQueueProvider` option to specify a custom default queue provider.
• Changed – Remove dependency on System.Data.SqlClient for Hangfire.SqlServer (by @0xced).
• Changed – Set default value for the `QueuePollInterval` option to `TimeSpan.Zero`.
• Changed – Polling delay when `QueuePollInterval` is set to zero now defaults to 200 ms.
• Changed – Sliding invisibility timeout-based fetching method is now used by default with a 5-minute timeout.
• Changed – Use command batching by default with a 5-minute maximum timeout.
• Changed – Enable the `UseRecommendedIsolationLevel` option by default.
• Changed – `GetJobData` now populates the `JobData.ParametersSnapshot` property to avoid additional roundtrips.
• Changed – Display scheduled and processing jobs in ascending order in Dashboard UI.
• Changed – Implement the `Transaction.AcquireDistributedLock` feature.
• Changed – Implement the `GetSetCount.Limited feature`.
• Changed – Implement the `GetSetContains feature`.
• Changed – Bump the internal version of Dapper to 2.0.123.
• Changed – Enable common metrics for SQL Server storage to be shown by default.
• Changed – Enable the `Monitoring.AwaitingJobs` feature for SQL storage.
• Deprecated – `UsePageLocksOnDequeue` option is now obsolete and doesn't affect anything.

Hangfire.SqlServer.Msmq

• Breaking – Dropped the `NET45` platform target in favor of the `NET451` target to support Visual Studio 2022.