How To: Host and Deploy Blazor WebAssembly using Netlify and Azure Pipelines

Tutorial for hosting and deployng blazor using netlify and azure

Johan Boström

3 minute read

With Blazor making an entry on the web application scene with its WebAssembly version. I thought it would be good to make a little how-to regarding hosting and deployment.

Since Blazor comes with two different types of hosting models this makes it possible to host your applications using a static web host. The best part of that is that there are many alternatives for good static web hosting that is free. I this post I will focus on host provider Netlify and also on how to build and deploy using Azure Pipelines.

TL;DR; Azure Pipeline file and example can be found at my GitHub zarxor/Blazor.NetlifyDeploy

Creating a site on Netlify

There are a few ways of creating a site on Netlify, you can either go through the creation wizard on the site (this requires the application to have a GIT repo on GitHub, GitLab or BitBucket). Or you can use netlify-cli to manually create an empty site.

To create a site using the netlify-cli you can install the CLI using npm.

npm install netlify-cli -g

After installing the Netlify CLI you need to login.

netlify login

This will open up a web browser allowing you to login to you Netlify account. After this you can create a new site.

netlify sites:create

Choose your team and choose a name, after the command you will be given a url and a Site ID. We will need the site id later.

Created site in console for netlify

Creating an API key for Netlify

To be able to deploy to Netlify through Azure Pipelines you will need an API key. You can create this by going to User Settings -> Applications -> Personal access tokens (or Then click on New access token, enter a description and then click on Generate token.

Generatiing PAT

Save this token for later!

Setting up your Blazor project

For your Blazor application to be able to play nice with Netlify you need to add a file called _redirects to your wwwroot folder. What this file will do is to redirect all traffic to your Blazor APP.


/*   /index.html   200

Creating your Azure DevOps Pipeline

Start by adding your azure-piplines.yml to your project, then setup you regular build steps. Add a variable for an output directory (buildOutput) for your blazor application. This will be used to ensure the output for the Blazor application is the same as the folder being published by netlify-cli.

Next we will need to install the netlify-cli in the build process, for this we will use npm.

Install step

# Install netlify-cli
- script: npm install netlify-cli 
  displayName: 'Install netlify-cli'

Before deploying we need to setup two variables with the Site Id and Api Key that we created in the step Creating a site on Netlify.

Setup netlify api keys in azure devops pipelines

After this we can use the netlify-cli to deploy the site.

Deploy step

# Deploy the wwwroot from the output directory
# The argument "--prod" deploys to production
- script: npx netlify deploy --prod --dir $(buildOutput)/wwwroot --site $(netlify_site_id) --auth $(netlify_api_key)
  displayName: 'Deploy site to Netlify'

After this your pipeline should be complete and a it should publish and deploy your site to Netlify.

Complete azure-pipelines.yml

- master

  vmImage: 'ubuntu-latest'

  buildConfiguration: 'Release'
  buildOutput: '.dist' # Output directory for publish

# Publish Blazor App
- script: dotnet publish --configuration $(buildConfiguration) --output $(buildOutput)
  displayName: 'Publish Blazor Site'

# Install netlify-cli
- script: npm install netlify-cli 
  displayName: 'Install netlify-cli'

# Deploy the wwwroot
# The argument "--prod" deploys to  
- script: npx netlify deploy --prod --dir $(buildOutput)/wwwroot --site $(netlify_site_id) --auth $(netlify_api_key)
  displayName: 'Deploy site to Netlify'

All the code

You can find the full code example on github here: The repo above publishes to this demo site: