rss feed Hangfire Core

Maintenance release with fixed recurring jobs behavior when they were scheduled to the past after calling the AddOrUpdate method in some corner cases, and added experimental parallel execution for recurring and delayed job schedulers via the new MaxDegreeOfParallelismForSchedulers option when supported by a storage implementation. The fixes are also backported to version 1.7.37.

Patch release with fixed regression in Hangfire.AspNetCore 1.8.9, bumped dependencies and signed NuGet packages and all the assemblies with a company code signing certificate using an awesome SignPath tool.

Minor release with fixed possible NullReferenceException on the Deleted Jobs page, and improved debugging experience through the added source link support with embedded symbols that reference source files in the GitHub repository.

Maintenance release that brings numerous minor fixes and improvements for the different parts of Hangfire.

This patch release has several unrelated changes, mainly to polish things and fix some minor problems. Please see the details below.

Maintenance release that allows specifying a favicon for the Dashboard UI, fixes regression for disabled recurring jobs, allows to serialize the AutomaticRetryAttribute filter, and fixes Hangfire.SqlServer’s backward compatibility issue with databases that use the old Schema 5 version.

This is a patch release that slightly improves the shutdown pipeline of a background job server and allows to get the current server id from IServerFilter implementations.

This correcting release fixes possible ObjectDisposedException in tests when using a background job server as a hosted process in ASP.NET Core, and a rare issue with the delayed job scheduler, when a scheduled background job was changed bypassing Hangfire API.

Maintenance release that fixes recurring job problems related to the new MisfireHandlingMode.Ignorable mode and adds a few other minor changes.

Patch release that fixes InvalidOperationException from new SQL Server metrics and occasional “Can not start continuation” error when using Hangfire.InMemory or Hangfire.Pro.Redis storage.

Correcting release that adds missing configuration methods, contains important fixes for the Hangfire.SqlServer storage and adds some tweaks for the Dashboard UI.

Maintenance release that fixes possible blocked workers’ problems when using multiple servers in the same applications that listen to different queues with the Hangfire.SqlServer storage. This is a regression appeared in version 1.7.33 when client waiting was implemented.

Finally Hangfire 1.8.0 is here. The latest version offers a set of great new features like first-class queue support for background jobs, the enhanced role of the Deleted state that now supports exceptions, more options for continuations to implement even try/catch/finally semantics, better defaults to simplify the initial configuration and various Dashboard UI improvements like full-width and optional dark mode support.

4^th release candidate of the upcoming Hangfire is here. Version 1.8 offers a set of great new features like first-class queue support for background jobs, the enhanced role of the Deleted state that now supports exceptions, more options for continuations to implement even try/catch/finally semantics, better defaults to simplify the initial configuration and various Dashboard UI improvements like full-width and optional dark mode support.

3^rd release candidate of the upcoming Hangfire is here. Version 1.8 offers a set of great new features like first-class queue support for background jobs, the enhanced role of the Deleted state that now supports exceptions, more options for continuations to implement even try/catch/finally semantics, better defaults to simplify the initial configuration and various Dashboard UI improvements like full-width and optional dark mode support.

Small maintenance release that adds reschedule overloads for BackgroundJob and IBackgroundJobClient types and fixes tricky case with generics and inheritance when creating a background job.

Patch release that implements sliding invisibility-based fetch logic with waiting on client’s side instead of SQL Server’s one (so wait statistics will be clear now) and uses SQL Server as a time authority for server heartbeats (unsynchronized clock will not cause servers to suddently disappear). Also implemented IAsyncDisposable support for service scopes in modern .NET Core applications.

Maintenance release with added Swedish translation of the Dashboard UI and other minor tweaks.

Maintenance release that adds RecurringJob.TriggerJob method that returns identifier of a triggered background job, bumps Moment.js packages used by Dashboard UI to 2.29.4 and contains fixes for the pt-BR translation.

This version contains even better implementation of ASP.NET application shutdown detection logic – detection timer was replaced with a dedicated thread to make it work even when ASP.NET killed all the thread pool threads, and yet another check based on internal state was implemented for more reliable detection.

This is a maintenance release that adds more protection to its internal components to prevent and diagnose high CPU consumption when something goes wrong with wait implementation. Uncatchable exceptions like OutOfMemoryException and StackOverflowException are not not handled by Hangfire to avoid leaving the process in a inconsistent state. Finally command batching now works with Microsoft.Data.SqlClient package. Also some very minor features were added, please see the release notes for details.

This release contains important fixes for SQL Server-based job storage to work better with sub-second polling (including TimeSpan.Zero for QueuePollingInterval) and properly send heartbeats for long-running jobs even if CLR’s Thread Pool is starved for long periods of time. It is also very likely that some problems related to high CPU usage and high number of fetching queries occurring after deploying new application version to IIS were also fixed (they are almost impossible to catch up, but same workaround already helped in the past).

The last preview version of the 1.8 release that adds support for dark mode for Dashboard UI (UseDarkModeSupportForDashboard configuration method should be called, since extension packages don’t support this mode yet), allow to use custom JavaScript and CSS files and improve default settings for SQL Server-based job storage to match the recommended options whenever possible.

This is a maintenance release that adds Turkish language and fixes 85% and less zoom in Safari for the Dashboard UI, and contains some other minor fixes.

This security patch fixes a regression appeared in the previous version 1.7.25 that makes Dashboard UI available for remote requests in the default configuration, e.g. when no authentication filter specified. Please note that when custom authentication filter is defined as recommended in the documentation, everything works as expected, but upgrade is recommended in any case. Please read the GHSA-7rq6-7gv8-c37h security advisory for details.

Maintenance release that bumps dependencies in Dashboard UI to the latest patch versions, fixes exception when trying to add a continuation for an already expired job when using Hangfire.SqlServer and contains other minor tweaks.

This beta finally adds the Queue property directly to a job and adds all the required overloads to BackgroundJob, RecurringJob classes and IBackgroundJobClient and IRecurringJobManager interfaces to specify queues dynamically at run-time and preserve them between retries. Dashboard UI is now implemented in full-width, so long method names are no longer a problem.

This is a maintenance release that adds support for async authorization filters via the new DashboardOptions.AsyncAuthorization property, contains small improvements for the Dashboard UI and stops using readcommittedlock table hint when not required in the Hangfire.SqlServer package.

Maintenance release that resolves the NotImplementedException exception in the EnlishPromotableSinglePhase method when running on Mono, makes IdempotentCompletionAttribute work regardless of the current serializer settings and also fixes some other minor issues.

Maintenance release for 1.6.X branch with some fixes backported from recent 1.7.X versions, including a fix for possible connection leak in Hangfire.SqlServer when an exception is thrown while releasing a distributed lock.

Hangfire 1.8.0-beta2 and beta1 recently released. The new versions bring a lot of improvements to create more complex workflows with new continuation options, improve role of the DeletedState that now has its own exception information and displayed on graphs when supported by an underlying storage, bring more methods for underlying abstractions to reduce the number of round-trips to a storage and other features as well. Also this version has better defaults for Hangfire.SqlServer package, and sliding invisibility timeout option will now be used by default.

This release bumps package versions referenced by Dashboard UI and fixes a possible reason for non-disposed SqlConnection instances in Hangfire.SqlServer storage when distributed lock release throws an exception (possible when using DisableConcurrentExecution filter with long-running jobs).

This maintenance release adds Norwegian translation, fixes problem with changing time zone of a recurring job, contains improvements for .NET Core integration and fixes Schema 6 migration (for those who didn’t apply it yet) that modifies the last Id column that’s still based on Int32 type, to use Int64 instead.

This is a maintenance release that adds German localization for Dashboard UI (thanks @d-oit!), adds IGlobalConfiguration.UseMaxArgumentSizeToRender extension method and fixes some minor issues. Dominik Oswald, Jurriaan Wijnberg and Jeremy Hayes, thanks for your help!

This release contains a new option SqlServerStorageOptions.DeleteExpiredBatchSize to let expiration manager delete more expired records in a single pass when processing workload is large enough.

This maintenance release only fixes a regression appeared in Hangfire 1.7.15 when using SQL Server 2008 or SQL Server 2008 R2, related to changed queries for “upsert” operations.

This release addresses a blocking issue appeared in version 1.7.9, where workers were unable to pick up new jobs when application is using multiple SQL Server storage instances in the same process with same queue names for each storage.

This release adds the IGlobalConfiguration.UseMaxLinesInExceptionDetails option to cap exception details when background jobs fail with an exception and forces only the first 100 lines of a stack trace to be persisted by default to avoid uncontrollable storage size growth. Also some improvements for SQL Server storage were added.

New version fixes a regression appeared in 1.7.13 which causes unexpected duplicate entries in the JobParameters table when using SQL Server as a job storage with older schemas (V5 and below). This problem is caused by a changed query in the previous version, and that change is rolled back now. No other manual steps required to fix the issue.

This version contains fixes for some corner cases in Hangfire.SqlServer, minor enhancements for Hangfire.Core and Catalan translation for Dashboard UI. Thank you Abraham Gausachs, Tomasz Malinowski and Will for your help with this release!

French translation added in this patch release (thank you @PaulARoy!), and now full absent type or method details will be shown in the Job Details page instead of the “Can not find the target method” error message. It turns out there was a simple and non-breaking implementation for this important improvement I could find for a long time. Some help from the storage is needed for this change to work, and Hangfire.SqlServer 1.7.12 and Hangfire.Pro.Redis 2.7.4 already provide it.

These versions contain important fixes for the whole processing pipeline, including fire-and-forget, delayed and recurring jobs in the presence of custom extension filters that can throw exceptions. Also a built-in support for reliable shutdown detection of ASP.NET applications was added to the Hangfire.Core package to prevent running old code base when the new one is already deployed. And recurring jobs page in 1.7.11 now displays all the exceptions that prevent a particular recurring job from being scheduled.

The new version contains authorization filters based on the non-obsolete IDashboardAuthorizationFilter interface appeared in Hangfire 1.6.0 (so it doesn’t work on previous versions), adds support for custom crypto-providers for Basic Authentication and fixes issues with wrong AssemblyFileVersion attribute.

New version contains important changes for Hangfire.SqlServer package, fixing a possible DbConnection leak after a database was taken offline and reducing the database load when sub-second polling interval is used. There are also some minor improvements for the Dashboard UI.

This version contains improvements for recurring jobs, support for Microsoft.Data.SqlClient package, experimental ability to use background job results in continuations (after calling the IGlobalConfiguration.UseResultsInContinuations extension method), even better integration with .NET Core 3.0 and bunch of other fixes.

This is a maintenance release that contains useful enhancements for Dashboard UI, support for command batching even in .NET Core when using System.Data.SqlClient 4.7.0 and higher, support for the Microsoft.Data.SqlClient package in Hangfire.SqlServer (postponed to 1.7.8) and other minor changes.

This is yet another maintenance release with added support for dashes in queue names (thanks, @augustoproiete), better recurring job error messages in Dashboard UI and some other useful fixes.

This is a maintenance release that provides better handling of recurring job scheduling errors, clearly shows when there are problems with fetching statistics in Dashboard UI (thanks, @prochnowc!), doesn’t infinitely caches IBackgroundJobClient and IRecurringJobManager instances that throw JobStorage.Current is null exceptions, and also adds the AddHangfireServer overload with options-based callback.

This is a maintenance release that contains important fixes for the Hangfire.SqlServer package to avoid deadlocks if you have long-running jobs, improvements for background process dispatch loop’s implementation, and also an interesting experimental feature that can transparently make background job creation resilient to transient exceptions by using idempotent retries.

This version contains security fixes to prevent possible XSS attacks as described in #1441. They don’t relate to user data submitted to Hangfire directly via method arguments, but it’s recommended to upgrade anyway. If you are using Hangfire 1.6, please upgrade to version 1.6.26 instead.

This patch release contains stability improvements for recurring jobs, better handling of custom time zone resolvers in Dashboard UI and other minor fixes. If you are upgrading from 1.6.X, please see Upgrading to Hangfire 1.7 article to learn the details.

This is a patch release that adds some nice features for Dashboard UI, knows how to deal with recurring jobs with invalid Cron expressions, and contains some minor improvements for SQL Server storage. Also, Hangfire.NetCore package was added to support new .NET Core Worker Service applications without referencing any ASP.NET Core packages.

Hangfire 1.7.0 is finally released with the whole bunch of new features and improvements for background processing, background and recurring jobs, SQL Server storage, .NET Core integration and interoperability between .NET platforms to provide a strong foundation for future features and extensions.

This is a release candidate for the upcoming version 1.7.0 with a lot of new features and improvements for almost all the aspects of background job processing. Below you’ll find a short list of them as well as upgrade details, and more information will be published later. Please note this is a pre-release, and it’s not suitable for critical environments.

This version fixes some issues and acts as an optional trampoline to the upcoming 1.7.0 release to simplify the rolling upgrades. So your current servers will work side-by-side with the newer ones even if you are using SQL Server as a job storage and applied the new migration. There will be more information on upgrading, but this version is nice-to-have (but not required) anyway.

This version finally fixes interoperability issues that arise, because primitive built-in types like String reside in assemblies with different name in .NET Core (System.Private.CoreLib.dll) and .NET Framework (mscorlib.dll). This led to JobLoadException in .NET Framework-based applications, when they tried to perform background jobs created by a .NET Core-based one. The new version solves this problem by re-writing assembly name when resolving a type for a job and its parameters.

This are late release notes for a maintenance release with minor fixes. Please see the list of fixed issues below and upgrade if necessary.

This release contains fixes for security issues related to dashboard, so it is highly recommended to upgrade. Cross-Site Request Forgery protection was added by using existing libraries, but methods are different across application frameworks:

This release fixes a regression appeared in 1.6.18 as well as contain some improvements for the Hangfire.SqlServer package.

This release contains a lot of fixes, but the most important ones are related to .NET Core and ASP.NET Core frameworks. Filters based on attributes are now working fine there, and DisplayName decoration will finally bring the human-ready name for your jobs. Other fixes are mostly related to dashboard.

This release contains important improvements when SQL Server is used as a job storage. Distributed locks are much more robust now even when there are significant connectivity issues (like those sometimes happen in Azure or other cloud environments) and require much fewer connections to SQL Server. Another improvement is related to a new option that allows transactions to be committed with fewer round-trips.

This is yet another maintenance release that fixes a bunch of non-critical bugs in Hangfire.Core and Hangfire.SqlServer packages.

This release contains important fixes for the Hangfire.SqlServer package, which is actively using the sp_getapplock stored procedure to synchronize work between different servers. I’ve realized that locks shouldn’t be awaited on SQL Server’s side, because this may lead to SQL Server’s connection pool starvation, because each blocked request will block a single worker thread.

This versions adds possibility to use non-transactional message fetching algorithm when using Hangfire.SqlServer package. This is especially helpful, if you have a lot of long-running background jobs, since they may prevent you from taking transaction log backups, leading to the Transaction log is full due to ‘ACTIVE_TRANSACTION’ error.

This release contains a bunch of fixes for core and integration packages. The most important updates are fix for SQL connection leaks when we failed to acquire a distributed lock, and wrong queue selection, when continuation is created after antecedent job is finished. So upgrade is recommended.

This release brings better exception handling policy for state changing pipeline. Previously, non-transient exception in a state filter could cause a worker to perform retries for affected background job infinitely. And a large number of such background jobs could stall the processing.

This release fixes a problem with CSS and JS files in dashboard appeared in 1.6.10, as well as corrects the authorization behavior, when the User property is null.

This is a maintenance release that contains fixes for job continuations and some dashboard issues related to Content Security Policy and recurring jobs page. It’s highly recommended to upgrade to prevent problems with continuations. They are rare, but lead to significant headache.

This is a small correcting release that make it possible to have a workaround for TimeoutException exceptions when using SQL Server with huge arguments or batches. The SqlServerOptions.CommandTimeout option was added to allow to override the default timeout of 30 seconds.

This release contains a bunch of minor fixes, mostly for Dashboard UI.

This is a correcting release that brings fixes to fully support generic methods, whose generic arguments are defined in their parameters, including List<T> and T[]. A lot of issues with Dashboard UI that cause exceptions and other errors, like uncontrolled growth of event listeners on resize, were also fixed. Please see the full delails below.

This is a correcting release that fixes a regression, when using generic methods of a scoped variable in expression for background jobs, as well as some minor optimizations for SQL Server. It also adds CLS compliance for basic packages, since public API is already compliant. Boring release, nothing interesting here.

This correcting release contains a lot of stability improvements for Hangfire.SqlServer, especially for SQL Azure Database environments. Processing is now more predictable even in Basic pricing tier, there is a special harness application that’s running 24/7 to ensure everything is fine. Some problems related to I18N, authorisation and continuations were also fixed.

This release fixes a problem that caused SqlConnection instance to leak when nested distributed locks are acquired for the same resource. If you are using batches, or continuations, and SQL Server as a storage, it is highly recommended to upgrade to prevent connection pool starvation and timeout exceptions.

This is a maintenance release that contains fixes for several bugs. It is highly recommended to upgrade to this version, if you are using Hangfire.SqlServer. Thanks to all folks who helped with reporting and investigating these issues!

This correcting release contains important fixes for SQL Server and MSMQ integrations, as well as some cosmetic changes to the Dashboard UI. Major blocking problem was resolved, when using Hangfire with SQL Server, that may cause a lot of blocking records in the State table, preventing background processing from working flawlessly, when expired records are removed from a database – Database Engine didn’t use the right index during the query performance.

This is a correcting release that fixes a couple of problems, including exception when using Serilog (appeared in 1.6.0), wrong CRON format strings for intervals, and ones that relate to the .NET Core platform. They were revealed by adding support to continuously run unit tests on Windows, Linux and OS X for the .NET Core using AppVeyor and Travis CI.

Hangfire 1.6 just released with experimental .NET Core platform support, deep integration with ASP.NET Core and async/await programming model support. Start processing background jobs with ease even on Linux and OS X today!

This release contains major bug fixes, and is very recommended to upgrade. In short, OperationCanceledException doesn’t cause background processing to stop now. Dashboard UI doesn’t leak READ UNCOMMITTED isolation level, and READ_COMMITTED_SNAPSHOT option doesn’t lead background jobs to stuck in Enqueued state.

This release fixes a bug appeared in version 1.5.6 of the Hangfire.SqlServer package. There was a race condition between the Timer and Worker threads, that causes the following problems, especially when small background jobs are processed.

Third beta of the upcoming 1.6 release. Contains a fix for a bug introduced in the previous beta, related to inability to add custom filters, as well as fixes from the recent 1.5.7 version.

This is a correcting release that contains a fix for Dashboard UI crashes when using MSMQ (finally, thanks @yangman for this!), as well as some other minor fixes.

This is the second beta of upcoming the 1.6 release. It contains some new features, but most importantly, it incorporates bug fixes released with recent 1.5.5 and 1.5.6 versions related to SQL Azure and recurring jobs, please see them for more details.

This release fixes an issue related to SQL Azure and background jobs, running more than 30 minutes. The problem is caused by Azure Database Engine which closes idle connections after 30 minutes of inactivity. Hangfire now periodically sends “keep-alive” queries to prevent this.

This is a correcting release that fixes a problem with recurring jobs. It is related to a possible misfire on a first run, if a background processing server was inactive during the scheduled time.

This is the first beta of an upcoming 1.6 release. Added support for async background job methods, ability to access context when creating an IoC container scope, dashboard with i18n support, redesigned Job Details page and zero latency for simple setup with SQL Server.

This is a correcting release that is highly recommended to install. It fixes issue related to daylight savings in recurring jobs, and prevents infinite loop when changing state of a background job that doesn’t exists (for example, when deleting a job).

This is a recommended update for all users of Hangfire.SqlServer. It addresses to fix a bug presented in version 1.5.0, associated with incorrect acquiring/releasing of distributed locks after network problems, that may lead to Cannot release the application lock exceptions and other issues related to synchronization.

This is a hotfix for Hangfire 1.5.1 users. If you are using one of previous versions, you are unaffected by this bug.

This is a correcting release that fixes some non-critical bugs.

Finally after 4 months of development and after 4 betas, Hangfire 1.5.0 released. Now you are able to customize your background processing pipeline even more, by using many types that were internal in previous versions. More responsive dashboard, IoC container scopes, support for remote MSMQ queues and other cool features are waiting for you!

This is a correcting release that fixes problems with TaskCanceledException thrown by a job method as well as issue with MSMQ extension, when background jobs are created within a TransactionScope block.

Version 1.5.0 will open many types that were internal in previous versions of Hangfire, like Worker or IBackgroundFactory, to enable you to have completely custom background processing. This release simplifies the usage of these types, of course only to decrease the amount of questions on forums .

This is a maintenance release that fixes deadlocks in expiration manager, SQL command timeouts in distributed locks (and in the DisableConcurrentExecution filter) and correctly handles poison messages in a schedule.

This is a pre-release version that adds a lot of great new features for Hangfire requested by you, including background processes, built-in support for custom scopes in IoC containers, queues for recurring jobs and much more!

This is a correcring release that fixes NotSupportException: This stream does not support seek operations bug added in 1.4.4. This exception is raised on all unbuffered HTTP POST requests to the Dashboard.

This is a correcting release that contain some fixes for the Dashboard UI:

This is a correcting release that allows Hangfire to work with databases with case-sensitive and binary collations and fixes some other problems. Integration tests now are running against a case-sensitive database to reduce the probability of a mistake.

This is a correcting release that contains some bug fixes.

About 4 months passed since release of version 1.3, and I’m pleased to introduce the next major release – Hangfire 1.4 with a lot of new features added and a lot of stability improvements made. This is the most important upgrade since version 1.0.

This is a pre-release version of Hangfire 1.4.0 that is considered to be stable (and it is more stable than 1.3.x). Final version will be released after documentation changes (some awesome features added, please see 1.4.0-beta1).

This is a pre-release version of Hangfire 1.4.0 that is considered to be stable.

This pre-release contains a lot of new features of an upcoming Hangfire 1.4.0 – continuations, time zone support for recurring jobs, new dashboard ui, new configuration classes.

This is a correcting release that fixes hourly/weekly statistics display in Dashboard, and a rare issue when we trying to cancel a recurring job from a client filter.

This is a correcting release. Fixed a bug related to MSMQ or RabbitMQ extensions, when enqueued job is not processed and “stuck” in the Enqueued state indefinitely until we retry it manually.

This is a correcting release. Expiration manager does not attempt to remove all the records at once now. Instead, it removes them by 1000 at a time, so you won’t experience timeout exceptions anymore. If you had problems with recurring jobs, they were fixed also.

Logging that just works

Hangfire has finally reached the 1.0 milestone! This means that public API is frozen and considered to be stable. Starting from now, the SemVer 2.0 specification will be used for versioning every package (but there may be exceptions, follow the README for each package).

Recurring jobs

Cancellation tokens

Batch operations

Note. The following information may be outdated after 1.0 release. Please see the official documentation first.

Today I’ve pushed the next version of Hangfire project that allows to process background jobs inside ASP.NET applications in a reliable way.