Serving your Azure App Service under your custom domain

Includes redirecting from your to your custom domain

Published on Thursday, November 15, 2018

If you host your App Service on Azure you get a default address that is a sub domain of If you are not just hosting a backend or personal web application where the url doesn't matter, you might want to add your custom domain. In this blog post I want to show a few things that you have to set up to achieve.

First you have to purchase your desired domain at any registrar that offers it.

If you have purchased your domain you will need a DNS Service. Which you have to configure so that your domain name gets resolved to your Azure App Service. For all my web pages I am using Cloudflare as my DNS service, because the service that Cloudflare offers is just amazing. And there is a free tier solution at Cloudflare.


After creating an account at Cloudflare we can add our site to the account. Cloudflare will automatically scan your domain for any previous DNS entries and for your current Nameservers. After your site was added to your account you have to change the current nameservers at your domain to the Cloudflare ones. Cloudflare has great tutorials on how to do that.


Next you will have to configure your DNS entries. Go back to the Azure Portal and open the App Service -> Your App Service -> Custom Domains Panel blade.


Click the Add hostname button and enter your domain / hostname you want to configure and click Validate. Azure will now check your DNS entries and since we don't have any configured yet the validation will fail. But the good thing is that Azure will show you what you will have to configure in your DNS to make it work. So go back to Cloudflare and add the records as shown in the Portal and revalidate. Your validation should now pass. Congratulations now your custom domain is hooked up with Azure.


If you came this far your web app gets served under your custom domain but it is also still accessible through the Azure sub domain. If you do not want your web page to be served under the Azure subdomain you can add a Url Rewrite section to your web.config. This will look like this (don't forget to replace {YOUR_DOMAIN} with your information):

<?xml version="1.0" encoding="utf-8"?>
  <location path="." inheritInChildApplications="false">
        <remove name="aspNetCore" />
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
      <aspNetCore processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout">
        <environmentVariables />
          <rule name="Redirect azurewebsites-domain to custom-domain" stopProcessing="true">
            <match url=".*" />
              <add input="{HTTP_HOST}" pattern="^{YOUR_DOMAIN}$" />
            <action type="Redirect" url="https://{YOUR_DOMAIN}/{R:0}" appendQueryString="true" redirectType="Permanent" />

If you add this you will automatically get redirected to your custom domain if you try to call the subdomain.

comments powered by Disqus