Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.suga.app/llms.txt

Use this file to discover all available pages before exploring further.

Custom domains let you serve your Suga services from your own domain (e.g., app.example.com) instead of the auto-generated Suga domains.

​
How It Works

When you add a custom domain to a service, Suga provides the DNS records you need to configure with your DNS provider. Once the records are in place, Suga automatically verifies ownership and provisions TLS certificates. No manual certificate management required. What you get:
  • Automatic TLS certificates
  • Cloudflare CDN, WAF, and DDoS protection
  • Zero-downtime certificate renewals

​
Adding a Custom Domain

1

Select your service

Click on the service you want to assign a custom domain to.
2

Open the Config tab

In the properties panel, open the Config tab.
3

Add a custom domain

In the Public Networking section, click + Custom Domain. Enter your domain name (e.g., app.example.com) and the target port your application listens on (e.g., 3000).
4

Configure DNS

Suga will display the DNS records you need to add. Create a CNAME record with your DNS provider pointing your domain to the provided Suga target.Example:
TypeNameTarget
CNAMEappprovided-target.suga.app
5

Deploy

Click Deploy Changes.
6

Wait for verification

Once your DNS records propagate, Suga automatically verifies your domain and provisions a TLS certificate. This typically takes a few minutes. Your service will then be accessible at your custom domain.

​
Apex Domains

Apex (root) domains like example.com (without a subdomain prefix) require special DNS support because the DNS specification doesn’t allow CNAME records at the zone apex.
Your DNS provider must support CNAME flattening, ANAME, or ALIAS records to use an apex domain. Not all providers support this.

​
Supported DNS Providers

Providers that support CNAME flattening or equivalent include:
ProviderMechanism
CloudflareCNAME flattening (automatic for apex)
NS1ANAME records
DNSimpleALIAS records
Constellix / DNS Made EasyANAME records
EasyDNSALIAS records
DigitalOcean DNSALIAS records (CNAME flattening)
NamecheapALIAS records
Netlify DNSALIAS records
AWS Route 53 and Azure DNS support ALIAS records, but only for pointing to their own services. They do not support arbitrary external targets. These will not work for Suga custom domains.
Some traditional registrar DNS providers (e.g., GoDaddy) do not support any of these mechanisms. You’ll need to either switch to a supported provider or use a subdomain instead. Check your DNS provider’s documentation if you’re unsure whether they support this.

​
Configuring an Apex Domain

When you add an apex domain, Suga will provide two DNS records:
TypeNameTarget / Value
CNAME@provided-target.suga.app
TXT@suga-verification=...
  1. Add both the CNAME (or ALIAS/ANAME equivalent) and the TXT record with your DNS provider
  2. Wait for DNS propagation and automatic verification
  3. Deploy your changes
If your DNS provider doesn’t support CNAME flattening, you can use a subdomain like www.example.com or app.example.com and redirect to it from the apex domain.

​
Common Questions

Usually a few minutes, but DNS propagation can take up to 48 hours depending on your provider and TTL settings.
Yes. Add each domain separately through the Public Networking configuration.
No. Suga automatically provisions and renews SSL/TLS certificates for all custom domains.
Yes. The auto-generated Suga domain continues to work alongside your custom domain.
Standard DNS does not allow CNAME records at the zone apex. Your provider needs to support CNAME flattening, ANAME, or ALIAS records. If it doesn’t, use a subdomain like www.example.com with a redirect instead.

​
Next Steps

Networking

Learn about HTTPS endpoints, TCP proxy, and private networking

Service Configuration

Configure environment variables, resources, and scaling