Custom domains

Every environment gets a *.velumi.dev URL automatically. You can add your own domain on paid plans.

Adding a domain

Open the environment and go to the Domains tab. Click Add domain, pick one of your managed domains, and enter the subdomain part (for example app for app.example.com, or leave it empty for the root). Choose a role and add it. Velumi sets up the DNS for the hostname automatically — there's no record to configure by hand.

Domain roles

RoleBehavior
PrimaryThe canonical URL for this environment. Each environment has exactly one primary domain.
AliasAdditional hostname routed to the same environment. How the domain is used is up to your application — it could serve different content, a different language, or anything else.
RedirectMarks the domain as intended for redirecting to the primary. Redirect behavior is handled by your application.

The first domain you add to an environment is automatically set as Primary. Subsequent domains default to Alias.

A domain's hostname and role cannot be edited after creation. To change either, remove the domain and add it again.

Removing a domain

Click the remove button on the domain row. Every environment must have at least one domain — the last domain cannot be removed.

If you remove the Primary domain, the next domain in the list is automatically promoted to primary.

noIndex

Toggle noIndex on a domain to tell search engines not to index pages served from it. This sets a X-Robots-Tag: noindex header on all responses.

Use this on staging and preview environments to prevent them from appearing in search results.