Custom Domains
Connect your custom domain to CupaDev with automatic SSL certificates and global DNS.
Quick Start
Adding a custom domain takes just a few minutes:
Add Domain in Dashboard
Go to your project settings and click "Add Domain". Enter your domain name (e.g., example.com or www.example.com).
Configure DNS
Update your domain's DNS records with your domain registrar:
Verify & Activate
CupaDev automatically verifies DNS configuration and provisions an SSL certificate. Your domain will be live within minutes.
DNS Configuration
Different record types for different domain configurations:
Root Domain (example.com)
Use an A record pointing to our IP:
Subdomain (www.example.com, api.example.com)
Use a CNAME record:
Pro Tip: WWW Redirect
Add both example.com and www.example.com. CupaDev will automatically redirect one to the other based on your preference.
Configure redirect behavior in Project Settings → Domains → Redirect Options
SSL Certificates
Every domain on CupaDev gets automatic, free SSL certificates powered by Let's Encrypt.
Automatic SSL
SSL certificates are automatically provisioned, renewed, and managed. No configuration needed.
Certificates renew automatically before expiration
No additional cost for SSL
Covers all subdomains with *.example.com
SSL handled at edge for faster connections
Advanced Configuration
Redirect Rules
Configure how traffic is redirected between your domains:
- Redirect www to root domain (or vice versa)
- Force HTTPS for all connections
- 301 permanent redirects for SEO
Custom SSL Certificates
Enterprise customers can upload their own SSL certificates:
- Go to Project Settings → Domains
- Click "Upload Custom Certificate"
- Provide certificate, private key, and chain
- CupaDev will validate and deploy your certificate
Multiple Domains
You can add unlimited domains to a single project:
- • example.com (primary)
- • www.example.com (redirect to primary)
- • app.example.com (subdomain)
- • example.co.uk (additional TLD)
Troubleshooting
Domain shows "DNS not configured" error
DNS records haven't propagated yet. This can take up to 48 hours but usually completes within minutes.
Check your DNS configuration with: dig example.com
SSL certificate not provisioning
Ensure DNS is correctly configured and pointing to CupaDev. SSL certificates are issued after DNS verification.
If DNS is correct, wait 5-10 minutes for certificate provisioning.
Domain works but shows different content
Make sure the domain is assigned to the correct project and deployment in your CupaDev dashboard.
How to remove a domain
Go to Project Settings → Domains → Select domain → Remove. The domain will be immediately unlinked from your project.
Verify DNS Configuration
Use these commands to verify your DNS is configured correctly:
Check A Record
dig example.com AShould return: 76.76.21.21
Check CNAME Record
dig www.example.com CNAMEShould return: cname.cupadev.com