Skip to content

Commit 51bc1cc

Browse files
authored
Refine title and enhance document clarity
Edit Review in progress
1 parent a13f714 commit 51bc1cc

1 file changed

Lines changed: 21 additions & 43 deletions

File tree

support/azure/app-service/connection-issues-with-ssl-or-tls/troubleshoot-custom-domain-issues-azure-app-service.md

Lines changed: 21 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Troubleshoot Custom Domain Issues in Azure App Service for web apps on Windows and Linux
2+
title: Troubleshoot Custom Domain Issues in Azure App Service for Web Apps on Windows and Linux
33
description: This article helps developers and IT admins troubleshoot custom domain issues in Azure App Service for web apps on Windows and Linux.
44
author: JarrettRenshaw
55
manager: dcscontentpm
@@ -12,62 +12,40 @@ ms.custom: sap:Connection issues with SSL or TLS, SSL Certificates and Domains
1212
---
1313
# Troubleshoot custom domain issues in Azure App Service for web apps on Windows and Linux
1414

15-
When adding a custom domain to an Azure App Service as a web app,
16-
misconfigurations can lead to validation errors, domain name service
17-
(DNS) resolution failures, or SSL issues. This guide provides:
15+
When you add a custom domain to an Azure App Service as a web app, misconfigurations can cause validation errors, domain name service (DNS) resolution failures, or SSL issues. This guide provides:
1816

19-
- A step-by-step troubleshooting flow, featuring a linear process to assist with diagnosing and fixing custom domain problems.
17+
- A step-by-step troubleshooting flow, featuring a linear process to help you diagnose and fix custom domain problems
2018

21-
- Common issues and solutions, featuring a catalog of frequently reported issues with their causes and resolutions.
19+
- Common issues and solutions, featuring a catalog of frequently reported issues together with their causes and resolutions
2220

2321
## Troubleshooting steps
2422

25-
Perform the following troubleshooting steps in order. This helps clarify
26-
the issue and guide you to a solution.
23+
Perform the following troubleshooting steps in the given order. This process helps clarify the issue and guides you to a solution.
2724

2825
### Step 1: Verify prerequisites and platform support
29-
Ensure the following are in place:
30-
31-
**App Service plan tier** - Confirm your web app isn't on the Free or
32-
Shared tier. Custom domains are only supported on Basic (B1) and higher
33-
tiers. If you're on a Free or Shared tier, scale up to at least B1
34-
before proceeding. For more information, see [How to add custom domain for my API web app](/answers/questions/5618685/how-to-add-custom-domain-for-my-api-web-app).
35-
36-
**User permissions** - Ensure you have the correct Azure role on your
37-
App Service. You need to be an Owner or Contributor on the web app's
38-
subscription or resource. If you're not allowed to add a hostname (for
39-
example, the validation fails immediately or the option is greyed out),
40-
you might lack permission. Have a subscription admin grant you access.
26+
27+
Make sure that the following items are established:
28+
29+
**App Service plan tier** - Verify that your web app isn't on the Free or Shared tier. Custom domains are supported on only Basic (B1) and higher tiers. If you're on a Free or Shared tier, scale up to at least B1 before you proceed. For more information, see [How to add custom domain for my API web app](/answers/questions/5618685/how-to-add-custom-domain-for-my-api-web-app).
30+
31+
**User permissions** - Make sure that you have the correct Azure role on your App Service. You have to be an Owner or Contributor on the web app subscription or resource. If you're not allowed to add a hostname (for example, the validation fails immediately or the option is greyed out), you might lack permission. Ask a subscription administrator to grant you access.
32+
4133
For more information, see [Troubleshoot domain and TLS/SSL certificate problems in Azure App Service](/troubleshoot/azure/app-service/connection-issues-with-ssl-or-tls/troubleshoot-domain-and-tls-ssl-certificates).
4234

4335
**Domain ownership** - You must own the domain name. Make sure you
4436
have access to the DNS provider for that domain (for example, GoDaddy or
4537
Namecheap) to create or modify DNS records. If you don't control the
4638
DNS, you can't complete the mapping. For more information, see [Set up an existing custom domain in Azure App Service](/azure/app-service/app-service-web-tutorial-custom-domain).
4739

48-
**No conflicting use** - Check that the domain isn't already bound to
49-
another Azure resource. A domain can only be linked to one App Service
50-
(including Azure Static Web Apps and Azure Front Door)at a time. If you
51-
previously used this domain on another app (like in a different
52-
subscription or a now-deleted app), remove it there first. In cases
53-
where the old app is inaccessible, you may need to contact [Azure
54-
support](https://azure.microsoft.com/support) to release the domain
55-
from that prior association. Azure can manually unbind a *locked* domain
56-
that's still tied to a resource you no longer control. For more
57-
information, see [Unable to Reuse My Custom Domain After Losing Access to Previous Azure Account](/answers/questions/2121811/unable-to-reuse-my-custom-domain-after-losing-acce).
58-
59-
**Resource locks** - Check if a resource lock is applied to your App
60-
Service or related resources. A *ReadOnly* lock on the web app prevents
61-
adding new hostnames. Similarly, if you purchased the domain with Azure
62-
as an App Service domain, ensure there's no lock on the domain resource
63-
that might prevent updates. Remove any locks before proceeding. They can
64-
be re-applied after configuration if needed.
65-
66-
### Step 2: Confirm DNS record configuration
67-
Custom domain mapping requires correct DNS records. A misconfigured DNS is
68-
the primary cause of custom domain issues.
69-
70-
Verify the following:
40+
**No conflicting use** - Check that the domain isn't already bound to another Azure resource. A domain can be linked to only one App Service (including Azure Static Web Apps and Azure Front Door) at a time. If you previously used this domain on another app (such as in a different subscription or a now-deleted app), remove it there first. If the old app is inaccessible, you might have to contact [Azure support](https://azure.microsoft.com/support) to release the domain from that previous association. Azure can manually unbind a *locked* domain that's still tied to a resource that you no longer control. For more information, see [Unable to Reuse My Custom Domain After Losing Access to Previous Azure Account](/answers/questions/2121811/unable-to-reuse-my-custom-domain-after-losing-acce).
41+
42+
**Resource locks** - Check whether a resource lock is applied to your App Service or related resources. A *ReadOnly* lock on the web app prevents you from adding new hostnames. Similarly, if you purchased the domain by having Azure as an App Service domain, make sure that no lock exists on the domain resource that might prevent updates. Remove any locks before you proceed. They can be re-applied after configuration, if it's necessary.
43+
44+
### Step 2: Verify DNS record configuration
45+
46+
Custom domain mapping requires correct DNS records. A misconfigured DNS is the primary cause of custom domain issues.
47+
48+
Verify the following items:
7149

7250
**Determine the record type** - Are you mapping a root or apex domain
7351
(like *contoso.com*) or a subdomain (like *www.contoso.com*)?

0 commit comments

Comments
 (0)