DocsOverviewQuick StartFrameworksDeploymentsDomainsEnv VarsFeature FlagsAI GatewayAPI ReferenceWebhooks

Custom Domains

Add a custom domain

Point your own domain to your Deploxa deployment. SSL is automatically provisioned and renewed via Let's Encrypt — no configuration needed.

Setup in 3 steps

1

Add the domain in Deploxa

Navigate to Project → Settings → Domains and enter your domain name. You can add both apex domains (example.com) and subdomains (app.example.com).

2

Add DNS records

Add the records below at your DNS provider (Cloudflare, Route 53, Namecheap, etc.). Deploxa shows you the exact records to add after you enter your domain.

Apex domain (example.com)

TypeNameValueTTL
A@203.0.113.103600
AAAA@2001:db8::103600

Subdomain (app.example.com)

TypeNameValueTTL
CNAMEappcname.deploxa.app3600

Using Cloudflare? Set the record to DNS Only (grey cloud), not Proxied. Deploxa handles SSL termination at the edge — double-proxying causes certificate errors.

3

Verify and SSL provisions automatically

Once your DNS records propagate (typically 1–30 minutes, up to 48h for some registrars), Deploxa automatically issues a TLS certificate via Let's Encrypt. You'll see a green checkmark and Valid status in the domain settings.

SSL Active — expires in 89 days

Renews automatically. No action required.

Wildcard domains

Wildcard domains (*.example.com) let you serve multiple subdomains from a single domain configuration — useful for multi-tenant apps or per-customer subdomains.

TypeNameValueTTL
A*203.0.113.103600
CNAME*cname.deploxa.app3600

Wildcard SSL certificates require DNS validation. Deploxa will prompt you to add a _acme-challenge TXT record to your DNS zone. This is a one-time step. Wildcard domains are available on Pro and Team plans.

Multiple domains per project

You can add multiple domains to a single project. All domains point to the same active deployment. Deploxa redirects all domains to your primary domain by default — you can change the redirect behavior per domain.

example.comPrimary
www.example.comRedirects to primary
app.example.comActive

Troubleshooting

My domain shows "Invalid" after I added DNS records.

DNS propagation can take up to 48 hours. Check propagation at whatsmydns.net. Make sure you removed any conflicting records (e.g., an existing A record before adding the CNAME).

I see a certificate error in the browser.

SSL provisioning triggers automatically after DNS verification. If it's been more than 5 minutes after verification, try clicking "Renew Certificate" in the domain settings panel.

I'm using Cloudflare and getting redirect loops.

Set the Cloudflare proxy mode to "DNS Only" (grey cloud). Deploxa handles SSL termination — proxying through Cloudflare on top causes loops.

DeploymentsEnvironment Variables