My scenario

I was just doing an upgrade of this Umbraco website from 8.4.0 to 8.6.4, everything went smoothly locally, but when it came to doing the upgrade on the live site, I saw a message like this:

The service is unavailable.

The url was as expected

But for some reason I was getting this weird error and I didn't know how to get past it.

It had to be something to do with the configuration I had on the production site that wasn't on the local one.

I did some googling and I found an issue in the Umbraco GitHub repo which seemed to describe my problem and I found a good solution in the comments.

So for anyone else who is searching for this now or myself searching for it again in 6 months, here was the code which solved it:

The solution

I just needed to add this line to the umbraco location path config setting in the main web.config file.

<httpErrors errorMode="Custom" existingResponse="PassThrough" />

Here it is with the rest of the code that is already in the file:

<location path="umbraco">
        <urlCompression doStaticCompression="false" doDynamicCompression="false" dynamicCompressionBeforeCache="false" />
        <httpErrors errorMode="Custom" existingResponse="PassThrough" />

The solution was to let the errors pass through. Who knew?

You can also do it for the install path:

<location path="install">
        <urlCompression doStaticCompression="false" doDynamicCompression="false" dynamicCompressionBeforeCache="false" />
        <httpErrors errorMode="Custom" existingResponse="PassThrough" />

Anyway I hope this helped you out in your hour of need.

Paul Seal

Umbraco MVP and .NET Web Developer from Derby (UK) who specialises in building Content Management System (CMS) websites using MVC with Umbraco as a framework. Paul is passionate about web development and programming as a whole. Apart from when he's with his wife and son, if he's not writing code, he's thinking about it or listening to a podcast about it.

Proudly sponsored by


  • Moriyama build, support and deploy Umbraco, Azure and ASP.NET websites and applications.

  • CI/CD service for Windows, Linux and macOS
  • Build, test, deploy your apps faster, on any platform.

  • is the easy error logging and uptime monitoring service for .NET.
  • Take back control of your errors with support for all .NET web and logging frameworks.
uSync Complete

  • uSync.Complete gives you all the uSync packages, allowing you to completely control how your Umbraco settings, content and media is stored, transferred and managed across all your Umbraco Installations.

  • More than a theme for Umbraco CMS, take full control of your content and design with a feature-rich, award-nominated & content editor focused website platform.

  • Affordable, Geo-Redundant, Umbraco hosting which gives back to the community by sponsoring an Umbraco Open Source Developer with each hosting package sold.