Contact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.

Creating a CDN resource with an Yandex Object Storage origin bucket

Written by
Improved by
Updated at May 7, 2026

Note

For details on creating an origin group and a CDN resource with other origin types, see these guides:

Set up content distribution over a CDN with an Object Storage bucket as the origin:

  1. Create a CDN resource.
  2. Configure a CNAME for your domain.
  3. Test the CDN.

Getting started

  1. Make sure you have a domain name and can access the DNS settings on your DNS hosting provider’s website. This is usually the company that registered your domain.

  2. Navigate to the management console and log in to Yandex Cloud or sign up if not signed up yet.

  3. If you do not have a folder yet, create one.

    Learn more about creating a folder

    1. In the management console, in the top panel, click or and select the cloud.

    2. To the right of the cloud name, click .

    3. Select Create folder.

      create-folder1

    4. Give your folder a name. The naming requirements are as follows:

      • Length: between 3 and 63 characters.
      • It can only contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.

    5. Optionally, specify the description for your folder.

    6. Select Create a default network. This will create a network with subnets in each availability zone. Within this network, you will also have a default security group, within which all network traffic will be allowed.

    7. Click Create.

      create-folder2

  4. If you do not have an Object Storage bucket yet:

    1. Create a bucket.
    2. Enable public access to the objects in the bucket and the object list.
    3. Upload your content to the bucket.

Create a CDN resource

  1. Go to Cloud CDN.

  2. In the CDN resources tab, click Create resource.

  3. Under Main settings, configure the basic CDN resource settings:

    • Under Content:

      • Enable Enable access to content.

      • In the Content query field, select From one origin.

      • In the Origin type field, select Bucket.

      • In the Bucket field, select the bucket you created in Object Storage.

      • In the Origin request protocol field, select HTTP.

      • In the Domain name field, specify the primary domain name you will use in your website links to CDN-hosted content, e.g., cdn.example.com.

        Alert

        You cannot change the primary domain name used for content distribution after creating a CDN resource.

    • Under Additional settings:

      • In the Redirect clients field, select Don't use.

      • In the Certificate type field, select Don't use.

      • In the Host header field, select Custom.

      • In the Header value field, specify the domain name from the bucket URL in <bucket_name>.storage.yandexcloud.net format, omitting the schema (http or https), e.g.,

        my-bucket.storage.yandexcloud.net

        Warning

        If the Host header is misconfigured, Object Storage will return errors in response to CDN server requests.

  4. Click Continue.

  5. Under Caching, HTTP headers and methods, and Advanced, leave the default settings, then click Continue. You can configure these settings later, if required.

Wait until the resource is created. It may take up to 15 minutes.

Tip

We recommend prefetching large files (over 200 MB) into the CDN server cache. This is an optional step. If skipped, such content will be automatically cached on CDN servers when first accessed by the end user.

Configure a CNAME for your domain

  1. In the Overview tab on the CDN resource page, under DNS settings, copy the generated domain name in e1b83ae3********.topology.gslb.yccdn.ru format.

  2. Navigate to your domain’s DNS settings on your DNS hosting provider’s website.

  3. Edit the relevant CNAME record so that it points to the previously copied URL in the .topology.gslb.yccdn.ru domain. For example, if the content delivery domain name you specified when creating your CDN resource is cdn.example.com, you need to create the following CNAME record or use it to replace the current record for cdn:

    cdn CNAME e1b83ae3********.topology.gslb.yccdn.ru.

    Note

    Do not use an ANAME resource record with domain names for content distribution; otherwise, the end user will get a response from a CDN server not linked to the user geolocation. The response will always be the same for all users.

Test the CDN

  1. Wait for the DNS records to update. This may take a few hours.

  2. Make sure the cdn CNAME record in the DNS server's cache points to the generated URL, e.g., e1b83ae3********.topology.gslb.yccdn.ru.

  3. Open the website in your browser to make sure it is working. Here is an example:

    http://cdn.example.com/index.html

See also

Previous
Overview
Next
Creating a CDN resource with an origin server