arvumiDocs
Open dashboard
Browse documentation

Build & ship

Custom domains

Give your application its own address, with verified DNS and automatic HTTPS.

On this page

Start with the included address

Production is available at your-project.arvumi.com. Custom environments use their configured subdomain, and previews have generated URLs shown in the dashboard. Add a custom domain when you are ready to use your own address.

Add your domain

  1. Open the project’s Settings → Domains.
  2. Enter the hostname, such as www.example.com or example.com.
  3. Select production or a custom environment as the target.
  4. Choose the DNS mode that matches the hostname, then add the domain.
  5. Copy the DNS records displayed by Arvumi into your DNS provider.

Configure DNS

For a subdomain

Use CNAME mode. Point the hostname to the unique target displayed for this domain binding. It has the form d-TOKEN.domains.arvumi.com.

For a root domain

Use flattened mode with a provider that supports ALIAS, ANAME, or CNAME flattening. Point the root hostname at the displayed d-TOKEN.domains.arvumi.com target. Also add the ownership-verification CNAME displayed by Arvumi: _arvumi.example.com points to v-TOKEN.verify.arvumi.com.

Copy the exact records from the dashboard.

TOKEN is a placeholder, not a DNS value. Each binding has its own target. Do not use a fixed server IP, the Arvumi root domain, or another domain’s target. Use DNS-only records; disable proxying at your DNS provider.

Verify and activate

Arvumi checks DNS and provisions HTTPS after validation. The target environment must have a ready deployment before the domain can serve your application.

You can also request a DNS check with the CLI:

arvumi domain add www.example.com --mode cname
arvumi domain check www.example.com --wait
arvumi domain list

For an apex domain, use --mode flattened. These commands assume a linked project. They configure Arvumi; you still need to create the DNS records at your provider.

If your domain is not ready

  • Check that each record has the exact hostname and target shown in the dashboard. Some providers append your domain automatically.
  • Remove conflicting records at the same hostname and allow time for DNS changes to propagate.
  • For a root domain, confirm both flattening support and the verification CNAME.
  • If the status is missing_deployment, deploy the selected environment.
  • Use the domain’s latest status in the dashboard when retrying; HTTPS setup can take time after DNS becomes visible.