Create and set a custom domain for the content delivery via CDN

What is a custom domain?

A custom domain is a unique, branded domain name used for content delivery through a CDN. For example, if you have a website with the domain mywebsite.com, you create a CDN resource for static content delivery and specify a custom domain for it, such as cdn.mywebsite.com. This way, your static assets will be delivered to end users with URLs like cdn.mywebsite.com/sample.jpg. 

When specifying a custom domain, you can use any domain or subdomain for which you can edit the DNS records. Usually, for CDN resources intended to deliver static assets, our customers use a third-level domain based on their website domain, e.g. cdn.mywebsite.com. For CDN resources integrated with the entire site—second-level domains, e.g., mywebsite.com.

Set a custom domain (only for static CDN recources)

The instructions below describe how to set up a custom domain for static CDN resources with the addition of a CNAME record. Setting up a custom domain for CDN resources integrated with the entire site is different and involves delegating the domain to Gcore's NS servers. Check out the article to learn more: Create a CDN resource for the entire site.

1. When creating a CDN resource, enter your desired domain or subdomain name in the "Custom domain" section. Specify additional domains by clicking the "+" icon.

2. Copy the value cl-****.gcdn.co (which is unique for every account and the same for all custom domains of your account) from the "Set up your DNS" page. Click Confirm.

3. Go to your DNS provider’s website and create a CNAME record for the custom domain with the value in the previous step. The CNAME record should be specified as follows:

      Copy
      
    cdn mywebsite.com. cl-****.gcdn.co 

Replace cl-****.gcdn.co with the value specific to your account.

If you specified multiple custom domains in step 1, add CNAME records for all additional custom domains.

Use the dig command in the terminal or an online dig tool to check the record. If the record was added correctly, you will receive a response similar to the one specified above.

4. Complete the CDN resource creation. You will see the following pop-up window when all configurations are completed:

Check the DNS setup status

Our setup guide will verify that the configuration was completed successfully and identify any issues requiring resolution.

1. Open the settings of the CDN resource that you created.

2. Click "Setup guide".

3. A checklist will open, displaying each step of the configuration process. A check mark indicates that the step was successful. If any stage lacks a check mark, click on the step and follow the instructions to complete the configuration. When you're done, click Check DNS setup status.

If you see the message "DNS record hasn’t been set up", check your DNS hosting settings for configuration errors.

If you see the message "DNS record has been successfully set up", the configuration has been completed correctly.

To check the frontend of your integrated website, right-click on any static files and choose "Inspect". This will show you the content delivery URL where your file is served.

Specify additional domain (only for static CDN resources)

1. Go to the CDN resource list and click on the custom domain of the resource you want to configure.

2. In the "Custom domain" section, click the plus sign (+) next to the "Domain" field and enter your desired domain name(s).

3. Click Save changes at the bottom of the page.

Note: Add a CNAME record to your DNS following the instructions above for each additional domain.

Once the additional domains are set up, you can configure your website to deliver different types of static files from separate domains.