The Why and How of Hangfire

Some tips & tricks on how to use our favorite .NET task planner: Hangfire


Our client processes a lot of dossier creation each day from different sources from within each of their departments. All these dossiers are created within their own applications and are then sent to an application we developed for them. They wanted to automate this creation process and prevent as much load peaks as possible during business hours. The solution was a background process that they can run whenever they want.

For this use case (and because here at Foreach we have no fear of tools we do not know yet) we looked at a nice, light, easy to use framework called Hangfire. This framework would allow us to create and manage background tasks without having to create a background service on the server.

Hangfire gives the developer an easy way to create different kinds of tasks, one of them the task that we needed for our “dossier creation” process, a simple Fire and Forget job.

What is it?

Hangfire adds an extra layer on top of your code. You pass calls to Hangfire which stores it into its own database. Hangfire then manages the calls for you, so you do not have to worry about the work you’ve enqueued being blocking. If it fails, it even retries it automatically in the way you configured.

Hangfire also gives you a nice clean dashboard where you can look at your enqueued jobs and, if you so wish, manage them manually. It truly is a fun little framework.

Hangfire allows you to synchronously enqueue a job in your code, and executes this code asynchronously through a first come, first serve queue.

A few examples of the types of jobs:

  • Fire-and-forget (like we needed)

  • Delayed

  • Recurring (like a cron job)

  • Continuations of other jobs

The jobs you’ve enqueued will be saved inside a persistent storage of your own choosing. They support many popular storages, relational or document based.

The benefit is that, even during random shutdowns, your jobs are safe and ready to be handled when the application has restarted.

What if something went wrong and my job throws an exception? Nothing to worry about really. Hangfire has its own automatic retry mechanism that retries your jobs for you in an intelligent manner.

Hangfire uses workers to handle the tasks, you define the number of workers you want and they share the queue, running the tasks on a first come first serve basis. Hangfire’s UI is itself protected by an API key (a GUID which you define) and accessible from /hangfire if you have the API key.


Implementing Hangfire proved to be easy. By following the documentation we created a configuration file for Hangfire that looks like this.

You then wire it into your services with a single line of code: