Attaching a custom domain to a Vibecraft project

A domain is a unique, human-readable name that identifies a website on the internet, e.g., example.com. A custom domain allows users to access your published Vibecraft project using a short, memorable address instead of its default technical URL.

Domain registration is handled by specialized organizations called domain registrars. In most cases, you need to pay to register a domain, and the cost depends on your selected domain zone, e.g., .ru, .com, or .org, and the registrar. Domain registration must be renewed annually, usually for an additional fee. Remember to renew your registration; otherwise, you may lose your domain, and it will become available for registration by other users.

You can attach one or more custom domains to a Vibecraft project.

Warning

This feature is only available with the Vibecraft Pro service plan.

When you attach a domain, Yandex Cloud creates additional resources that are billed separately:

To attach a custom domain to a Vibecraft project, proceed as follows:

  1. Publish your Vibecraft project in Yandex Cloud.

  2. Register your domain with a domain name registrar.

  3. Open the Vibecraft home page.

  4. Under Projects, select your project.

  5. In the top-right corner, click Settings.

  6. In the window that opens, on the Domains tab, click Add domain.

  7. In the input field, specify the domain you want to attach, e.g., example.com or www.example.com. For details about restrictions on the root (apex) domains, see the next step.

  8. Select the domain attachment type. It determines how the domain resource records are configured:

    • Yandex Cloud DNS: Recommended option, in which the domain is attached automatically. Both root domains, such as example.com, and subdomains, such as www.example.com, are supported.

      To use this option, delegate domain management to Yandex Cloud DNS by specifying the ns1.yandexcloud.net. and ns2.yandexcloud.net. NS server addresses in your domain registrar account. Include the trailing dot in the addresses; it is part of the fully qualified domain name (FQDN).

      Example of configuring NS servers in Reg.ru

      Warning

      Check that your domain does not belong to an existing DNS zone in any Yandex Cloud folder. Otherwise, you will get the domain is occupied error when attaching the domain.

    • External DNS: Use this option if your domain is managed by a third-party provider. You will have to complete some domain association steps manually. You can only associate a subdomain, e.g., www.example.com. Apex domains are not supported under this option.

  9. Click Attach and complete the next steps based on your selected attachment type:

    Wait for the domain attachment to complete. Vibecraft will automatically perform the following actions:

    1. Issue a Let's Encrypt® certificate.
    2. Create a DNS zone in Yandex Cloud DNS.
    3. Add a TXT record to verify domain ownership.
    4. Create an API gateway in Yandex API Gateway.
    5. Add an ANAME or CNAME record pointing to the Serverless Containers repository URL hosting your project.

    1. At the Checking DNS stage, the options for resource records to verify domain ownership are displayed. Copy the type, name, and value of a record from the Vibecraft interface and them with your DNS provider:

      Type

      Name

      Value

      TXT

      _acme-challenge.<your_subdomain>.

      <verification_token>

      CNAME

      _acme-challenge.<your_subdomain>.

      <ID>.cm.yandexcloud.net.

      The <verification_token> and <ID> values are generated automatically. Their full values are displayed in the Vibecraft interface at the Checking DNS step.

      DNS record updates can take up to 72 hours. Wait until the record is verified and the next stage begins.

      Example of configuring resource records in Reg.ru

    2. Once the certificate is issued, delete from DNS provider the TXT or CNAME record you added for domain ownership verification.

    3. At the Attaching CNAME step, you will get a CNAME record pointing to the URL of a container in Serverless Containers hosting your project. Copy the value from Vibecraft and add the record with your DNS provider.

      Type

      Name

      Value

      CNAME

      <your_subdomain>.

      <ID>.apigw.yandexcloud.net.

The attachment process includes the following stages: Initialization → Issuing certificate → Checking DNS → Attaching CNAME → Complete.

After the Let's Encrypt® certificate for your website is issued, Yandex Cloud will notify you at the email address associated with your SourceCraft account.

Once all the stages are complete, your project will be accessible at your domain.

Useful links

Previous
Publishing a project
Next
About Vibecraft