Custom Domains
Default Domain
Every organization gets a default domain: your-org.deno.net
Apps are accessible at: your-app.deno.dev
Adding a Custom Domain
- Go to your organization's domains page in the Deno Deploy dashboard
- Click "Add Domain"
- Enter your domain (e.g.,
example.comor*.example.comfor wildcards) - Click "Add Domain" to see DNS configuration
DNS Configuration
You have three options for DNS setup:
Option 1: ANAME/ALIAS (Recommended)
Best option if your registrar supports ANAME or ALIAS records.
| Record Type | Name | Value |
|---|---|---|
| ANAME/ALIAS | @ | <your-app>.deno.dev |
| CNAME | _acme-challenge | (provided in dashboard) |
Option 2: CNAME
Works for subdomains (like api.example.com) but not for apex domains (like
example.com).
| Record Type | Name | Value |
|---|---|---|
| CNAME | api | <your-app>.deno.dev |
| CNAME | _acme-challenge.api | (provided in dashboard) |
Option 3: A Record
Most compatible, works with any registrar.
| Record Type | Name | Value |
|---|---|---|
| A | @ | (IP provided in dashboard) |
| CNAME | _acme-challenge | (provided in dashboard) |
Note: IPv6 is not supported with the A record method.
Cloudflare Users
If using Cloudflare, disable proxying (turn off the orange cloud) on the
_acme-challenge CNAME record. Proxying prevents certificate verification from
completing.
SSL/TLS Certificates
Automatic Certificates (Recommended)
After DNS verification completes:
- Click "Provision Certificate" in the dashboard
- Let's Encrypt generates your certificate
- Certificates renew automatically
Bring Your Own Certificate
If you need a specific certificate:
- Upload your PEM-formatted certificate file
- Upload your private key file
- You must manage renewal - notifications arrive 14 days before expiration
Warning: Expired certificates cause your domain to stop working.
Assigning Domains to Apps
- Go to organization domains page
- Find your domain and click to edit
- Assign it to an application
- Remove assignments from app settings if needed
Troubleshooting
| Issue | Solution |
|---|---|
| Verification stuck | Check DNS propagation (can take up to 48 hours) |
| Certificate won't provision | Ensure _acme-challenge CNAME is correct and not proxied |
| IPv6 not working | Use ANAME/ALIAS or CNAME instead of A record |
Documentation
- Domains reference: https://docs.deno.com/deploy/reference/domains/