Docs menu
Domains
Every environment gets a *.primcloud.app URL automatically. Add custom domains to any environment, with HTTPS included.
On this page
Every environment gets a *.primcloud.app URL when it's created. You can add custom domains on top, and Primcloud verifies them and serves them over HTTPS.
The primcloud.app URL#
Every environment answers at <app-slug>-<environment-slug>.primcloud.app, with HTTPS, from the moment it's created, so you have a working URL before your first deploy finishes.
It can't be renamed or removed. It's your primary URL until you make a custom domain primary, after which it redirects to that domain.
Adding a custom domain#
Add a custom domain from the application's Settings page. Enter the hostname (www.example.com, example.com, staging.example.com) and Primcloud shows the DNS records to add.
- Domains belong to an environment. Each environment has its own.
- A hostname can belong to one environment. One that's already added can't be added again.
- Wildcard domains (
*.example.com) need Pro or Team. On Standard, add each subdomain separately. *.primcloud.apphostnames can't be added; they're assigned automatically.
DNS setup#
Add two records at your DNS provider: a CNAME from your hostname to <region>.primcloudns.com, and a TXT record at _primcloud-verify.<your-hostname> that proves you control the domain. Once a domain is verified, its subdomains don't need the TXT record.
Subdomains (www.example.com, app.example.com) take the CNAME directly.
Root domains (example.com) usually can't have a CNAME. Use one of these instead:
- An ALIAS or ANAME record, if your provider supports one (DNSimple, Namecheap Premium, dnsExit, and others). It acts like a CNAME at the root.
- CNAME flattening, if your provider does it (Cloudflare does). Add the CNAME as normal.
Verification#
Primcloud checks your DNS once you add the domain. When it verifies, the domain shows Success, starts serving your app, and gets an HTTPS certificate. Certificates renew automatically, for custom domains and *.primcloud.app URLs alike.
If the records still aren't in place after 72 hours, the domain shows Failed. Hit Retry once your DNS is set up to check again.
Primary, alternative, and redirect#
Each environment has one primary domain, the address shown in the dashboard and in our emails. The *.primcloud.app URL is primary until you promote a verified custom domain from the domains panel.
Every other verified custom domain is either:
- Alternative: serves your app at that hostname too.
- Redirect: redirects visitors to your primary. Use it to send
wwwto your root domain, or the other way round.
Removing a domain#
Remove a custom domain with its delete button. Primcloud stops serving your app at that hostname right away. If it was primary, the *.primcloud.app URL becomes primary again with no downtime.
Warning
Visitors keep reaching Primcloud until you change your DNS, and they get an error page instead of your app. If you're moving the domain elsewhere, update your DNS at the same time.