Documentation

Domains

Every project has a free address on vtrex.app. Add your own domain and Vantrex serves it over HTTPS with a certificate it obtains and renews for you.

Adding a domain

  1. Add it

    Open the project, choose Domains, then Add and enter the hostname, for example www.example.com.

  2. Create the DNS record

    At your DNS provider, add the CNAME record shown for the domain:

    DNS
    www.example.com.   CNAME   <the target shown in the dashboard>

  3. Wait for it to verify

    The domain verifies itself as soon as the record resolves, which can take a few minutes. A certificate is issued automatically and the status changes to connected.

Root domains

DNS does not normally allow a CNAME on a root domain such as example.com. Options:

  • Use a provider that supports it. Cloudflare flattens a CNAME on the root automatically (use the name @). Others call the feature ALIAS or ANAME.
  • Or add www.example.com as the domain and redirect the root to it at your provider.

Verifying without moving traffic

If the domain is live somewhere else, you can prove ownership first with a TXT record shown in the dashboard and switch the CNAME when you are ready. A domain with a verified TXT record stays verified without pointing at Vantrex.

Production and branch domains

When adding a domain you choose its environment. A production domain always serves the current production deployment. A preview domain can be limited to one branch, which gives you a stable address such as staging.example.com that follows the latest commit of staging.

If a domain stops resolving

Vantrex rechecks your records. If neither the ownership record nor the CNAME can be found, the dashboard shows when the problem started. If it continues for 48 hours, the domain is disconnected from the project; add it again once the records are fixed.