Add a custom domain

1. Add the domain

   Open the project's Domains page and choose Add domain. Enter the hostname, www.example.com for instance, and choose what it does:

   • serve an environment: production, or another one;
   • or redirect to another domain of the project. See Redirects.

   A hostname can only belong to one project across Hiraiship. Hiraiship's own domains, hiraiship.app and hiraiship.com with all their subdomains, can't be added. The domain serves traffic only once it's verified.

2. Create the DNS records

   The domain's row shows the records to create at your DNS provider, where you bought the domain or where its DNS is hosted. Copy each value from the dashboard: they're specific to your domain.

   A subdomain (www.example.com, app.example.com) needs a CNAME:

   Type	Name	Value
   CNAME	www	fallback.hiraiship.app

   An apex domain (example.com) can't have a CNAME. It needs an ALIAS record, which some providers call ANAME or CNAME flattening:

   Type	Name	Value
   ALIAS	@	fallback.hiraiship.app

   If your provider has neither, serve the site from www.example.com, and redirect example.com to it from a provider that can.

   Until the domain is verified, the dashboard may also list TXT records. They prove you own the domain and let its certificate be issued: create them too.

3. Wait for verification

   DNS changes take from a few minutes to a few hours to spread. The status moves to Valid configuration on its own; choose Refresh on the domain to check right away. See Verification & SSL.

Domains on other environments

An environment other than production has no hiraiship.app address: a custom domain is how you reach it. Add staging.example.com, and choose staging as its environment.

Changing or removing a domain

Edit on a domain changes its environment, or turns it into a redirect. Removing it stops it from serving traffic right away; the DNS records at your provider stay until you delete them.

A domain other domains redirect to can't be removed: remove or change those redirects first.