Skip to main content

Manage user domains

Last update:

Objects in a public bucket can be distributed under your own (custom) domain. A custom domain is added at the bucket level. You can obtain an object via a custom domain using a link.

You can add custom third-level domains and higher.

You can add domains from external DNS hosting providers or domains delegated to Selectel DNS hosting.

For all custom domains, you must add TLS (SSL) certificates.

Add a user domain from Selectel DNS hosting

You can add a domain to an existing DNS hosting zone that is delegated to Selectel DNS hosting, or create a new zone while adding the domain.

After adding the domain, a resource record to connect to S3 (CNAME record) will be automatically created, pointing to the public domain of the bucket. A domain can have only one CNAME record. If you already have a CNAME record, it will be applied, and no duplicate record will be created.

If the automatically created CNAME record conflicts with other records, you will need to resolve the conflict yourself in your DNS hosting.

  1. Optional: create a new DNS hosting zone.
  2. Add the domain to the bucket.
  3. Add a TLS (SSL) certificate.

1. Optionally: create a new DNS zone

  1. In the control panel, on the top menu, click Products and select S3.
  2. Go to the Buckets section.
  3. Open the bucket page → Domains tab.
  4. In the Custom domains row, click Add.
  5. In the Domain binding block, in the Zone field, select New DNS zone.
  6. Enter the name of the DNS zone that is the parent for your domain. For example, if you are binding the domain first.example.com, the DNS zone will be example.com.
  7. Click Add.
  8. Delegate the domain.

2. Add the domain to the bucket

  1. Ensure that you have created a DNS zone and delegated the domain.

  2. In the control panel, on the top menu, click Products and select S3.

  3. Go to the Buckets section.

  4. In the control panel, go to S3Buckets.

  5. Open the bucket page → Domains tab.

  6. In the Custom domains row, click Add.

  7. In the Domain binding block:

    7.1. In the Zone field, select a DNS zone.

    7.2. In the Bucket address field, enter a subdomain in the DNS zone.

    7.3. Click Bind.

3. Add a TLS (SSL) certificate

Use the TLS (SSL) Certificates for Custom Domains guide.

Add a user domain from external DNS hosting

  1. Open the control panel of your DNS hosting.

  2. Create a DNS record and specify:

    A domain can have only one CNAME record.

  3. In the control panel, on the top menu, click Products and select S3.

  4. Go to the Buckets section.

  5. Open the bucket page → Domains tab.

  6. In the Custom domains row, click Add.

  7. In the Domain binding block:

    7.1. In the Zone field, select DNS zone from another DNS hosting.

    7.2. In the Bucket address field, enter the user domain.

    7.3. Click Bind.

  8. Add a TLS (SSL) certificate.

Disable a user domain

The user domain is disabled when the bucket type is changed to private or when the domain is deleted.

Delete a user domain

  1. In the control panel, on the top menu, click Products and select S3.
  2. Go to the Buckets section.
  3. Open the bucket page → Domains tab.
  4. In the row with the domain, click .