1. Home
  2. Docs
  3. Troubleshooting
  4. DNS Verification Issues

DNS Verification Issues

When DNS Verification fails for QUIC.cloud CDN, it is usually due to an incorrect configuration for your domain. Let’s take a look at some of the things that can go wrong, and how you can fix them.

In order for QUIC.cloud to act as a reverse proxy for your site, you need to do one of two things:

  1. Change the CNAME record at your DNS Provider so that it points to a domain that QUIC.cloud has provided to you. The domain will look something like c12345.tier1.quicns.com.
  2. Let QUIC.cloud be your DNS provider by changing the nameservers at your domain registrar to nameservers that QUIC.cloud provides. The nameservers will look something like kevin.quicns.com.

The issues that may arise with your configuration will vary depending on which of the above methods you used.

The CNAME Method

 

CNAME Not Supported on an Apex Domain

Most DNS providers do not support adding a CNAME record to an apex (or root) domain. If your website uses an apex domain by default, please confirm with your DNS provider that they support CNAME flattening or ANAME/ALIAS records. If they do not, you have three possible courses of action:

  1. Switch your DNS provider to QUIC.cloud. We offer a DNS service that is free to use, easy to switch to, and tightly integrated into the CDN.
  2. Switch to another DNS provider of your choice which supports CNAME flattening or ANAME/ALIAS records. As of this writing we know a few options are Cloudflare, DNSMadeEasy, and DNSSimple, however we cannot guarantee that these will always be available solutions.
  3. Shift your website away from an apex domain and into to a www domain or a subdomain. This method might have SEO-related ramifications, and you’ll need to be sure that old links forward properly to the new subdomain. So please be cautious while choosing this option.

The Map Both www/non-www Option is Incorrectly Enabled

When the Map Both www/non-www option is turned ON, QUIC.cloud will require that a CNAME record exists for both the apex domain and the www domain. In order to use this option then, your DNS provider must support CNAME flattening or ANAME/ALIAS records.

If your website’s exact domain is a www domain or a subdomain (and you don’t use the apex domain), then turn Map Both www/non-www OFF. This setup will be supported by any DNS provider.

CNAME is updated for www but not Apex Domain

If your website’s exact domain is an apex domain (example.com) but you have added a CNAME record for the www domain, verification will fail. This setup is incorrect. Please restore your previous DNS setup and then refer to "CNAME not supported on an Apex Domain" to find a suitable solution that will allow you use QUIC.cloud with your apex domain.

QUIC.cloud CNAME is Incorrectly Configured

QUIC.cloud provides a domain that must be added to a CNAME record in your domain’s DNS zone. The Name of the CNAME record should be your exact domain (www.example.com), and the Record should be the domain provided to you by QUIC.cloud (c12345.tier1.quicns.com). It is common to reverse these two fields, but that would be incorrect, as illustrated in the image below.

Both AAAA and CNAME Records Exist for Your Domain

If www.example.com and/or example.com are pointed to QUIC.cloud via a CNAME record (e.g. c12345.tier1.quicns.com), there should not be any AAAA records for www.example.com or example.com in your DNS zone. If both AAAA and CNAME records exist, please delete the AAAA records.

Cloudflare Shows an Orange Cloud

If you’re using Cloudflare as your DNS provider, and the DNS record for your website’s exact domain displays the orange cloud icon, your configuration is incorrect. An orange cloud indicates that your site is proxied by Cloudflare, which means it will not work with QUIC.cloud. Update your configuration so that the gray cloud icon is displayed. This indicates that Cloudflare will be bypassed and QUIC.cloud’s infrastructure will be utilized correctly, as illustrated in the image below.

The Nameserver Method

Nameservers Added to DNS Zone

It may seem like you should add NS records to your DNS Zone in order to start using QUIC.cloud’s nameservers, but this is incorrect and will not pass verification. Nameservers should be added at your domain registrar, as illustrated in the images below.

  • Incorrect:
  • Correct:

DNSSEC in Use

DNSSEC is not supported by QUIC.cloud. If you’re using DNSSEC on your domain, verifcation will fail. Please disable DNSSEC in order to use QUIC.cloud.

To test DNSSEC on your domain, try Google Public DNS. You can toggle DNSSEC validation to see records with and without DNSSEC.

DNS Not Yet Propagated

Changing nameservers can take anywhere from two to 24 hours. This is dependent on a lot of factors including your top-level domain, and your domain registrar. If you’ve recently changed your nameservers and have not made any of the previously listed mistakes, please wait for the nameserver changes to propagate and check again later.

Terminology

  • Exact Domain: When we say “Exact domain”, we mean the specific domain name that appears in your site’s URL. There can be three types of exact domains: apex or root, www, and subdomain.
    • Apex Domain: An apex domain is also called a root domain, or a top-level domain. You might also hear it referred to as a naked domain or a bare domain. It is the domain name without a www. or other subdomain in front of it. Example: example.com.
    • www Domain: If your URL is www. + your apex domain, then you have a www domain. Example: www.example.com.
    • Subdomain: This is similar to a www domain, and in fact a www domain is a specific type of a subdomain. You can technically use (pretty much) anything you want as a subdomain. Examples: blog.example.com, shop.example.com, i-love-subdomains.example.com.
  • DNS Provider: The DNS provider is the company whose nameservers your domain is using. If you forget who your DNS provider is, try https://gwhois.org.
  • DNS Zone: The DNS Zone is a set of records (A/CNAME/MX/TXT, etc.) hosted by your DNS provider. These records store the address to your website.
  • CNAME Flattening: CNAME flattening is a process which allows using a CNAME record for apex domains. (Usually CNAMEs are for subdomains.) The resulting records are also known as ALIAS or ANAME records, and many DNS providers do not support them.
Was this article helpful to you? Yes No 1