Contact UsGet started

Static website in Yandex Object Storage using the management console

Written by
Updated at May 14, 2025

To host a static website in Object Storage using the Yandex Cloud management console:

  1. Get your cloud ready.
  2. Create a public bucket.
  3. Enable a website for a bucket.
  4. Configure DNS.
  5. Upload the website files.
  6. Test the website.

If you no longer need the resources you created, delete them.

Get your cloud ready

Sign up in Yandex Cloud and create a billing account:

  1. Navigate to the management console and log in to Yandex Cloud or register a new account.
  2. On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one and link a cloud to it.

If you have an active billing account, you can navigate to the cloud page to create or select a folder for your infrastructure to operate in.

Learn more about clouds and folders.

The cost of hosting a static website includes:

Create a public bucket

To create a bucket for static website files:

  1. In the Yandex Cloud management console, select a folder to create a bucket in.

  2. On the folder page, click Create resource and select Bucket.

  3. In the Name field, specify the bucket name. Once configured, the bucket will be available at two addresses:

    • http(s)://<bucket_name>.website.yandexcloud.net
    • http(s)://website.yandexcloud.net/<bucket_name>

    The name must meet the following requirements:

    • The name must be from 3 to 63 characters long.
    • The name may contain lowercase Latin letters, numbers, hyphens, and periods.
    • The first and last characters must be letters or numbers.
    • The characters to the right and left of the period must be letters or numbers.
    • The name must not look like an IP address, e.g., 10.1.3.9.

    If you have a registered domain name (e.g., example.com) and want your website to be accessible at example.com, specify example.com as the bucket name.

    Note

    If you plan to use your own domain for the website, the bucket name must be an exact match of your domain name. Use a second-level domain or higher. For more information, see Custom domain.

  4. In the Object read access field, specify Public.

  5. Click Create bucket.

Enable a website for a bucket

  1. Upload and configure the home page and error handling page for your intended website. To do this, create the following files on your computer:

    • index.html containing the text Hello world!. The file contents will be displayed on the website's home page.
    • error.html containing the text Error!. The file contents will be displayed when the website responds with 4xx errors.

  2. Upload the files you created to the bucket:

    1. In the management console, select the folder where the bucket is located.

    2. From the list of services, select Object Storage. In the window that opens, select the bucket created earlier.

    3. In the left-hand panel, select Objects.

    4. Click Upload. In the window that opens, select the files you created and confirm the upload.

    5. In the left-hand panel, select Settings.

    6. On the Website tab:

      1. Navigate to the Website tab and select Hosting.
      2. In the Home page field, specify index.html.
      3. In the Error page field, specify error.html.
      4. Click Save.

  3. Make sure your website's home page opens. To do this, access the website from a browser at http://<bucket_name>.website.yandexcloud.net.

  4. Make sure the error page opens. To do this, access the website from a browser at http://<bucket_name>.website.yandexcloud.net/error-check.

By default, the website is only accessible over HTTP, e.g., at http://example.com.website.yandexcloud.net. To provide HTTPS support for your website:

  1. Add your own security certificate or a Let's Encrypt certificate in Yandex Certificate Manager.

  2. Configure HTTPS support for your bucket. Your website will then be accessible over HTTPS at https://example.com.website.yandexcloud.net.

    Note

    If you use such URLs as http(s)://<bucket_name>.storage.yandexcloud.net, the HTTPS protocol is available for the bucket only if the bucket name does not contain dots, e.g.:

    • https://example.storage.yandexcloud.net: HTTPS is available for this bucket.
    • http://example.ru.storage.yandexcloud.net: HTTPS is not available for this bucket.

    This is because Object Storage uses Wildcard certificates that only support one level of subdomains.

    To provide HTTPS support for a bucket with a dot in the name, upload your own security certificate to Object Storage.

  3. For access by the short domain name (example.com), configure DNS.

Configure DNS

If you have a registered domain name, assign it to the bucket. To do this, create an ANAME DNS record.

You can use Cloud DNS to manage the domain.

Note

The bucket name must be an exact match of your domain name. Use a second-level domain or higher. For more information, see Custom domain.

The tutorial below describes how to set up DNS for an example.com second-level domain.

Add a zone

To create a public DNS zone:

  1. In the management console, select the folder where you want to create a public zone.

  2. From the list of services, select Cloud DNS.

  3. Click Create zone. In the window that opens, specify the DNS zone settings:

    • Zone: Specify your registered domain name, e.g., example.com.. The field value must end with a trailing dot.
    • Type: Public.
    • Name: example-zone-1.

  4. Click Create.

Add an ANAME resource record

Create an ANAME resource record in the public DNS zone:

  1. In the management console, select the folder that houses the public DNS zone.

  2. From the list of services, select Cloud DNS and then, the DNS zone you created earlier.

  3. Click Create record. In the window that opens, set the record properties:

    • In the Name field, select Matches zone name (@).
    • In the Type field, select ANAME.
    • In the Data field, specify the resource record value, e.g., example.com.website.yandexcloud.net, where example.com is the name of the public bucket you created earlier.

  4. Click Create.

The domain name in the ANAME record must match the bucket name. For example, if you are creating an ANAME record named example.com, your bucket name should also be example.com.

Delegate the domain name

Delegation is the transfer of authority from the registrar's servers to yours. For a domain, NS resource records (ns1.yandexcloud.net and ns2.yandexcloud.net) are created.

To delegate a domain, specify its DNS servers in the registrar's account.

Delegation does not take effect immediately. It usually takes up to 24 hours (86,400 seconds) for internet service providers to update records. This depends on the TTL value, which specifies how long domain records are cached.

You can check domain delegation using Whois or the dig utility:

dig +short NS example.com

Result:

ns2.yandexcloud.net.
ns1.yandexcloud.net.

Upload the website files

After you configure and test availability, upload the remaining files required for website operation. To do this, use the management console, S3 API, Terraform, or other tools for operating Object Storage.

Test the website

To check that the website is running, use one of the standard Object Storage addresses:

  • http://<bucket_name>.website.yandexcloud.net
  • http://website.yandexcloud.net/<bucket_name>

If you have configured your own domain for a website, use its address, e.g., example.com.

How to delete the resources you created

To stop paying for the resources:

  1. Delete the files you uploaded.
  2. Delete the bucket.
  3. Delete the DNS zone.

See also

Previous
Overview
Next
Terraform