Getting started with Hangfire on ASP.NET Core and PostgreSQL on Docker

This post is about integrating Hangfire on ASP.NET Core with PostgreSQL database running on Docker.

Hangfire is an incredibly easy way to perform fire-and-forget, delayed and recurring jobs inside ASP.NET applications. No Windows Service or separate process required. Backed by persistent storage. Open and free for commercial use.

There are a number of use cases when you need to perform background processing in a web application.

  • mass notifications/newsletter
  • batch import from xml, csv, json
  • creation of archives
  • firing off web hooks
  • deleting users
  • building different graphs
  • image/video processing
  • purge temporary files
  • recurring automated reports
  • database maintenance

and counting..

We will get started by install and configure a database, then ASP.NET Core MVC, after which we will get to Hangfire and run few tasks with it.

Setup PostgreSQL database

There are more than one way to setup PostgreSQL database. I’m about to use Docker for the purpose, but you can go and install it directly from the Postgresql official webisite.

To continue we need Docker installed and running. Lets proceed with pulling the Docker image for PostgreSQL. Open terminal and run:

$ docker pull postgresql

After we have the image, we can run a container and provide username and password for the database:

$ docker run -d -p 5432:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres 

Create ASP.NET MVC project

So far we have the db up and running, let’s continue with the creation of the MVC project and configure it to use our database.

Create new folder and enter it:

$ mkdir aspnet-psql-hangfire && cd aspnet-psql-hangfire 

Now let’s create the MVC project. You can go with whatever you want from the list of available dotnet project templates.

$ dotnet new mvc 

Next install Nuget package for Entity Framework driver for PostgreSQL :

$ dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL

Add empty dbcontext :

using Microsoft.EntityFrameworkCore;

namespace aspnet_psql_hangfire.Models 
    public class DefaultDbContext : DbContext  
        public DefaultDbContext(DbContextOptions<DefaultDbContext> options) 
          : base(options) { }

Restore the packages by running:

$ dotnet restore

Edit appsettings.json and enter the connection string:

    "connectionStrings": { 
    "Logging": {
        "LogLevel": {
            "Default": "Warning"    
    "AllowedHosts": "*"

The framework must know that we want to use PostgreSQL database so add the driver to your Startup.cs file within the ConfigureServices method:

services.AddEntityFrameworkNpgsql().AddDbContext<DefaultDbContext>(options =>

After we have the connection ready, the initial migration(create the database) is coming:

$ dotnet ef migrations add InitialCreate && dotnet ef database update

Install Hangfire

Let’s continue with final steps – install packages for Hangfire:

$ dotnet add package Hangfire.AspNetCore && dotnet add package Hangfire.Postgresql 

Add the following using statement to the Startup.cs:

using Hangfire; 
using Hangfire.PostgreSql;

Again in the ConfigureServices method in the Startup.cs, let Hangfire server to use our default connection string:

services.AddHangfire(x => x.UsePostgreSqlStorage(

Again in Startup.cs, in Configure method enter:

app.UseHangfireDashboard(); //Will be available under http://localhost:5000/hangfire"

Then restore again the packages by typing:

$ dotnet restore

Create task

In the Configure method, below the app.UseHangFireServier() add the following tasks:

BackgroundJob.Enqueue(() => Console.WriteLine("Fire-and-forget"));

BackgroundJob.Schedule(() => Console.WriteLine("Delayed"), TimeSpan.FromDays(1));

RecurringJob.AddOrUpdate(() => Console.WriteLine("Minutely Job"), Cron.Minutely);

var id = BackgroundJob.Enqueue(() => Console.WriteLine("Hello, "));
BackgroundJob.ContinueWith(id, () => Console.WriteLine("world!"));

And finally run the app:

$ dotnet run 

If you observe the console, you can see that the tasks are executing. Now go to the dashboard provided by Hangfire at http://localhost:5000/hangfire for more task info.

Summary and further improvements

The dashboard is only available for localhost connections. If you would like to use it in production environment, you have to apply authentication. There are plenty of tutorials describing how to do that.

Here is the repo ( from the project, I hope you liked it. Happy coding!