Domain Configuration Guide

Quick Start: This guide covers DNS configuration for both apex domains and subdomains. Choose the method that best fits your infrastructure setup.

Apex Domain Setup Options

Configure your root domain (e.g., yourdomain.com) using one of these methods:

RecommendedOption 1: Nameserver Delegation

Delegate DNS management to our nameservers for optimal performance and automatic SSL certificate management.

Nameserver Configuration:

Primary:
ns1.vercel-dns.com
Secondary:
ns2.vercel-dns.com

Note: This method requires changing nameservers at your domain registrar. DNS propagation may take 24-48 hours.

Option 2: CNAME Record (Apex)

Use a CNAME record for the root domain. Note that not all DNS providers support CNAME at the apex level.

DNS Record Configuration:

Type:
CNAME
Name/Host:
@
Value/Target:
cname.vercel-dns.com
TTL:
3600 (1 hour)

Subdomain Configuration

Configure subdomains (e.g., app.yourdomain.com, api.yourdomain.com) using CNAME records.

Standard CNAME Configuration:

Type:
CNAME
Name/Host:
[subdomain]
Value/Target:
cname.vercel-dns.com
TTL:
3600 (1 hour)

Common Subdomain Examples:

app.yourdomain.com
Name:app
Target:
cname.vercel-dns.com
api.yourdomain.com
Name:api
Target:
cname.vercel-dns.com
admin.yourdomain.com
Name:admin
Target:
cname.vercel-dns.com
cdn.yourdomain.com
Name:cdn
Target:
cname.vercel-dns.com

DNS Verification & Testing

Command Line Verification

Use these commands to verify your DNS configuration:

# Check Apex Domain
dig yourdomain.com CNAME
nslookup yourdomain.com

# Check Subdomain
dig app.yourdomain.com CNAME
nslookup app.yourdomain.com

# Check nameservers
dig yourdomain.com NS

Online DNS Checkers

Provider-Specific Instructions

Cloudflare

For Cloudflare users, ensure the orange cloud is enabled for proxying.

Type: CNAME
Name: @ (for apex) or subdomain name
Target: cname.vercel-dns.com
Proxy status: Proxied (orange cloud)

AWS Route 53

Use Alias records for apex domains in Route 53.

Type: A
Name: @
Alias: Yes
Alias Target: cname.vercel-dns.com

GoDaddy

GoDaddy supports CNAME at apex level with their domain forwarding feature.

Type: CNAME
Host: @
Points to: cname.vercel-dns.com
TTL: 1 Hour

Troubleshooting

Common Issues

DNS Not Propagating

DNS changes can take 24-48 hours. Use online DNS checkers to verify propagation.

CNAME at Apex Not Supported

Some providers don't support CNAME at root level. Use nameserver delegation instead.

SSL Certificate Issues

SSL certificates are automatically provisioned once DNS is properly configured.

Debugging Commands

# Check if domain resolves
ping yourdomain.com

# Check DNS propagation
dig yourdomain.com @8.8.8.8
dig yourdomain.com @1.1.1.1

# Check SSL certificate
openssl s_client -connect yourdomain.com:443 -servername yourdomain.com

Important: DNS changes can take up to 48 hours to propagate globally. Most changes take effect within 1-2 hours, but full global propagation may take longer.

Visual Configuration Examples

Root Domain Nameserver Configuration

Nameserver Configuration

Example showing nameserver delegation for optimal performance and automatic SSL management

Subdomain DNS Configuration

Subdomain CNAME Setup

Example showing CNAME record configuration for subdomains

Additional Resources