Custom domain

You can use a custom domain, e.g., example.com, to publish your website.

To use a custom domain:

1. Create a bucket. Name it the same as your domain, e.g., example.com.

2. Configure the bucket as hosting.

3. On the DNS server, create a public DNS zone and a resource record to link your domain name to the bucket.

   This option is available for buckets with a dot in their name, e.g., example.com.

   Yandex Cloud DNS

   Third-party DNS server

   Warning

   Cloud DNS usage is chargeable; for more information, see Cloud DNS pricing policy.

   1. In the management console, select Object Storage from the list of services and go to the bucket you want to use your custom domain for.

   2. In the left-hand panel, select Settings and go to the Website tab.

   3. In Hosting, under Domains in Cloud DNS, click Create record.

      Note

      Under Domains in Cloud DNS in the Hosting section, you can only see those domains that were created directly through this interface. Records created in Cloud DNS will not be shown.

   4. In the window that opens, click Create zone and select the domain zone that matches the bucket name, e.g., example.com.. Click Create.

   5. Expand Additional settings.

   6. In the TTL (in seconds) field, specify the resource record time to live or select a value from the list.

   7. Click Create.

   8. Click Save.

   To gain access to public zone domain names, delegate the domain by specifying the ns1.yandexcloud.net and ns2.yandexcloud.net server addresses in your domain registrar account.

   Delegating a domain and updating resource records may take a while.

   You can also use Cloud DNSto create a DNS zone and resource record.

   Example of DNS zone and resource record parameters

   DNS zone parameters:

   • Zone: example.com.
   • Type: Public

   Resource record parameters:

   Name	Type	TTL	Value
   example.com.	ANAME	600	example.com.website.yandexcloud.net

   ANAME records enable using second-level domains for hosting. Unlike CNAME records, they do not restrict the use of other record types in the same zone.

   Here is an example of DNS zone parameters:

   • Zone: example.com.
   • Type: Public

   An example of a CNAME resource record looks like this:

   example.com CNAME example.com.website.yandexcloud.net
   

   To use a CNAME resource record, make sure your domain name belongs to at least a third-level domain. This restriction is due to the way CNAME records are handled on DNS hosting platforms. For more information, see RFC 1912, section 2.4.

   Updating resource records may take a while.

4. To make your website available over HTTPS:

   1. (Optional) Add your own certificate to Certificate Manager or issue a free-of-charge Let's Encrypt certificate.

      Note

      Certificate Manager usage is free of charge; for more information, see Yandex Certificate Manager pricing policy.

   2. Configure HTTPS by linking a Certificate Manager certificate to your bucket or uploading your own.

   Request redirects from HTTP to HTTPS are enabled automatically once you set up HTTPS access to a bucket. No other settings are required.

   Alert

   Starting July 1, 2025, Object Storage will discontinue support for the TLS protocol versions 1.0 and 1.1.

   For more information, see TLS protocol.

Once you successfully complete all the steps, you will have access to objects via links in <domain_name>/<object_key> format.