You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/azure/app-service/connection-issues-with-ssl-or-tls/troubleshoot-custom-domain-issues-azure-app-service.md
+21-43Lines changed: 21 additions & 43 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
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
3
3
description: This article helps developers and IT admins troubleshoot custom domain issues in Azure App Service for web apps on Windows and Linux.
4
4
author: JarrettRenshaw
5
5
manager: dcscontentpm
@@ -12,62 +12,40 @@ ms.custom: sap:Connection issues with SSL or TLS, SSL Certificates and Domains
12
12
---
13
13
# Troubleshoot custom domain issues in Azure App Service for web apps on Windows and Linux
14
14
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:
18
16
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
20
18
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
22
20
23
21
## Troubleshooting steps
24
22
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.
27
24
28
25
### 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
+
41
33
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).
42
34
43
35
**Domain ownership** - You must own the domain name. Make sure you
44
36
have access to the DNS provider for that domain (for example, GoDaddy or
45
37
Namecheap) to create or modify DNS records. If you don't control the
46
38
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).
47
39
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:
71
49
72
50
**Determine the record type** - Are you mapping a root or apex domain
73
51
(like *contoso.com*) or a subdomain (like *www.contoso.com*)?
0 commit comments