Skip to content

Configuring DNS for a Subdomain

These instructions take you through the general steps required to set up your DNS for use with a subdomain such as www.example.com or sub.example.com. If you would prefer to use your root domain (e.g. example.com), please see the main DNS area for the available options.

These instructions are for setting up your existing DNS records at an external DNS provider. If you are switching to QUIC.cloud DNS, please see Using QUIC.cloud DNS.

Keep a Reference

Log in to your DNS provider. The first thing you should do, before you change anything , is to take a screenshot of your configuration. You want to have a reference in case you encounter an issue and you want to revert back.

General Instructions

While logged into your DNS provider, you will need to perform these basic steps:

  1. Adjust the TTL on your subdomain's A record to be very short while you work on it
  2. Replace the A record with a CNAME record that points to the QUIC.cloud domain
  3. Adjust the TTL on the CNAME record back to what the original A record was

The process is described in more detail in the Detailed Instructions section below.

Provider-Specific Instructions

Here are some of the provider instructions we know about. If you don't see your DNS provider here, follow the Detailed Instructions below.

Detailed Instructions

Adjust TTL

If there is an A record for your subdomain, adjust the TTL value to the smallest time period possible. This is so that you can make changes and not have to wait a long time for them to take effect.

Once the previous TTL has passed, the new TTL will take effect.

Example

The previous value was 60 minutes and you change it to 2 minutes. If it is 3:00pm when you change the value to 2, you must wait 60 minutes before that value is effective.

Create a CNAME Record

The subdomain you are planning to use with QUIC.cloud needs to have a CNAME record.

  1. If there is currently an A record for the subdomain, delete it.
  2. Add a CNAME record. Set Name to your subdomain (www.example.com), Value to your root domain (example.com), and keep the TTL set to the lowest possible value.

Visit your site and verify that you can still access everything properly.

Tip

At this point, all you have done is make some local changes to your own DNS. QUIC.cloud is not involved in this process. If you are having issues accessing your site, then it is not related to QUIC.cloud. It is likely to be an error in your DNS configuration. Refer to the backup screenshot you took before you started.

Edit the CNAME Record

That CNAME record you added earlier now must be used to connect to QUIC.cloud. Edit it and change the Value field to the domain name given to you in your Dashboard (e.g. c12345.tier1.quicns.com).

Tip

If you don't see a domain name, you may need to enable the CDN first. Press theĀ Enable CDN button and check again.

Visit your site again and verify that you can still access everything properly.

If it is not accessible, review your DNS configurations and run through the steps again. Check if your TTL for the old configuration has expired. Make sure that the correct amount of time has elapsed.

Adjust TTL

Once you have verified that your site is still accessible, you are finished making changes to the DNS. You can set the TTL for your CNAME record to something more reasonable. Use the value of the original A record, if you're not sure.

Next Step

Once your DNS is set up, you're ready to enable the CDN.


Last update: February 3, 2024