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:

1

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).

2

Configure DNS

Update your domain's DNS records with your domain registrar:

Type: A
Name: @ (or your subdomain)
Value: 76.76.21.21
3

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:

Type
A
Name
@
Value
76.76.21.21

Subdomain (www.example.com, api.example.com)

Use a CNAME record:

Type
CNAME
Name
www
Value
cname.cupadev.com

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.

Auto-renewal

Certificates renew automatically before expiration

Free forever

No additional cost for SSL

Wildcard support

Covers all subdomains with *.example.com

Edge terminated

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:

  1. Go to Project Settings → Domains
  2. Click "Upload Custom Certificate"
  3. Provide certificate, private key, and chain
  4. 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 A

Should return: 76.76.21.21

Check CNAME Record

dig www.example.com CNAME

Should return: cname.cupadev.com