Savannah Cloud

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:

  1. Add the domain in the dashboard or API
  2. choose whether to use managed nameservers or a custom DNS provider
  3. validate the DNS records or nameserver delegation
  4. attach the domain to the target deployment or app
  5. let the platform issue and renew the TLS certificate automatically

Nameserver model

You can either:

  • point your registrar to ns1.savannahcloud.com and ns2.savannahcloud.com for full DNS management, or
  • keep your existing DNS provider and add the required CNAME or A records

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}/records

These 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

On this page