Cloud Deploy
Custom Domains
Add, verify, and manage custom domains for your Cloud Deploy site.
This guide covers adding, verifying, and managing custom domains for a Cloud Deploy site. Custom domains require a DNS connection (Cloudflare, AWS Route 53, etc.) so Orkestia can create or update DNS records.
Prerequisites
- DNS connection - Your organization must have at least one active DNS connection with the zone that contains (or will contain) your domain. See DNS Providers.
- Site infrastructure ready - The site must be Active (infrastructure status ready). You cannot add custom domains while the site is still provisioning.
Opening Domains Settings
- Open the site from the site overview
- Go to Settings → Domains
You'll see the CloudFront URL (default for the site) and the list of custom domains. If there are no DNS connections, a message explains that you need to connect a DNS provider first.
Adding a Custom Domain
Click Add Domain
From the Domains settings page, click Add Domain.
Fill in domain details
- Domain - Enter the full domain (e.g.
app.example.com,www.example.com, or apexexample.com) - DNS Connection - Select the DNS connection that manages the zone for this domain
- Zone - Select the DNS zone (e.g.
example.com) - Primary (optional) - When enabled, this domain is used as the primary domain for the site
- Proxy / Proxied (optional, Cloudflare only) - When enabled, traffic is proxied through Cloudflare
Submit and wait
Click Add (or Add domain). After adding, the domain enters a configuration phase.
Domain Statuses
| Status | Description |
|---|---|
| Pending | Domain was just added; configuration is queued or starting |
| Requesting SSL | SSL certificate is being requested (e.g. ACM) |
| Validating SSL | Certificate validation (e.g. DNS challenge) in progress |
| Configuring CDN | CloudFront is being updated with the domain and certificate |
| Configuring DNS | DNS records are being created or updated in your DNS provider |
| Active | Domain is configured and serving traffic |
| Failed | Configuration failed; use Retry or check logs |
| Deleting | Domain is being removed |
Domain Progress Modal
- View progress - From the domains list, click View progress for a domain that is still configuring
- The modal shows:
- Current step and status
- Progress (e.g. completed steps / total steps)
- Logs for each step
- When configuration completes successfully, the domain status becomes Active. If it fails, you can use Retry from the domains list.
Verify and Retry
| Action | Use Case |
|---|---|
| Verify | Use for domains that need DNS or certificate re-validation (e.g. after you changed DNS records manually) |
| Retry | Use after a Failed configuration to run the configuration again |
Both actions are available from the domain row in the Domains settings list.
Set Primary Domain
- One custom domain can be marked Primary
- The primary domain is used when a single canonical URL is needed (e.g. redirects or SEO)
- Click the action to Set as primary on a domain. The previous primary (if any) is unset.
Deleting a Custom Domain
- In the Domains list, click the delete (trash) action for the domain
- Confirm if prompted
- The domain status becomes Deleting and the domain is removed from CloudFront and (where applicable) DNS
Removing a custom domain does not delete the site; the site remains available on its CloudFront URL.
DNS Connection Required
If Add Domain is disabled or you see "DNS Connection Required":
- Go to Connections → DNS Providers
- Add and validate a DNS connection (Cloudflare, Route 53, etc.) that has the zone for your domain
- Return to Settings → Domains and add the domain again
See DNS Providers for provider-specific setup.