Attach a custom domain to a Vibecraft project

A domain is a unique name that identifies a website on the internet, such as example.com. A custom domain lets you open a published Vibecraft project using a short, memorable address instead of the automatically generated technical URL.

Domains are registered by special organizations called domain registrars. In most cases, domain registration is paid, and the cost depends on the selected domain zone, such as .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 available only with the Vibecraft Pro consumption plan.

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

To attach a custom domain to a Vibecraft project:

  1. Publish your Vibecraft project in Yandex Cloud.

  2. Register the desired domain with a domain name registration service.

  3. Open the Vibecraft home page.

  4. Under Projects, select the 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 to attach, for example, example.com or www.example.com. For details about restrictions on the root (apex) domain, see the next step.

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

    • Yandex Cloud DNS: The 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. In your domain registrar account, specify the following NS server addresses: ns1.yandexcloud.net. and ns2.yandexcloud.net. 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

      The domain must not be added to an existing DNS zone in any Yandex Cloud folder. Otherwise, the domain is occupied error occurs when you attach it.

    • External DNS: This option is suitable if a third-party provider manages the domain. In this case, some of the steps for attaching the domain must be completed manually. You can attach only a subdomain, such as www.example.com. Root (apex) domains are not supported for this option.

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

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

    1. Issues a Let's Encrypt® certificate.
    2. Creates a DNS zone in Yandex Cloud DNS.
    3. Adds a TXT record to verify domain ownership.
    4. Creates a gateway in Yandex API Gateway.
    5. Adds an ANAME or CNAME record that points to the Serverless Containers container URL with 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 one of the records from the Vibecraft interface and add them with your DNS provider:

      Type

      Name

      Value

      TXT

      _acme-challenge.<your_subdomain>.

      <verification_token>

      CNAME

      _acme-challenge.<your_subdomain>.

      <identifier>.cm.yandexcloud.net.

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

      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. At the Attaching CNAME stage, the CNAME record that points to the Serverless Containers container URL with your project is displayed. Copy the value from the Vibecraft interface and add the record with your DNS provider:

      Type

      Name

      Value

      CNAME

      <your_subdomain>.

      <identifier>.apigw.yandexcloud.net.

The attachment progress is displayed in the following stages: Initialization → Issuing certificate → Checking DNS → Attaching CNAME → Complete.

Once the certificate is issued, an email from Yandex Cloud about issuing a Let's Encrypt® certificate for your website is sent to the email address associated with your SourceCraft account.

Once all stages are complete, the project is available at your domain.

See also

Previous
Publishing a project
Next
About Vibecraft