Custom Domains & DNS
Provision, verify, and manage custom domains and DNS records for Savannah Cloud deployments.
Savannah Cloud supports custom domains for applications and deployments, with automatic DNS verification and certificate automation.
Domain workflow
To configure a custom domain:
- Add the domain in the dashboard or API
- choose whether to use managed nameservers or a custom DNS provider
- validate the DNS records or nameserver delegation
- attach the domain to the target deployment or app
- let the platform issue and renew the TLS certificate automatically
Nameserver model
You can either:
- point your registrar to
ns1.savannahcloud.comandns2.savannahcloud.comfor full DNS management, or - keep your existing DNS provider and add the required
CNAMEorArecords
This is the recommended model for multi-tenant domain management.
DNS verification
Verification runs automatically in the background. The platform checks:
- the expected DNS record or NS delegation
- the live host resolution state
- certificate readiness and issuance status
If verification fails, the platform surfaces the issue in the dashboard and retries on the scheduled background cadence.
Domain API
GET /dns/zones
POST /dns/zones
POST /dns/zones/{host}/recordsThese endpoints let you inspect and manage:
- zone records
- domain ownership
- DNS validation state
- record creation for subdomains and apex domains
Example record configuration
example.com. A 203.0.113.10
www.example.com. CNAME your-app.savannahcloud.com.For delegated domains, the registrar should point the zone to Savannah Cloud nameservers instead of static records.
TLS and certificates
Savannah Cloud supports:
- ACME-based certificate issuance
- wildcard certificate coverage where available
- automatic renewals before expiry
- deployment-level domain binding
Operational notes
- DNS verification runs every few minutes
- deployment domains are checked for readiness before launch completion
- stale or broken domain states are surfaced for remediation