Custom Domains

Connect your own domain name to your Easy Deploy applications for a professional, branded experience.

Quick Setup

Add Your Domain

In your application dashboard:

Go to Settings → Domains
Click “Add Custom Domain”
Enter your domain (e.g., myapp.com or app.mydomain.com)
Click “Add Domain”

Configure DNS

Point your domain to Easy Deploy by updating your DNS records:

For root domains (example.com):

Type: A
Name: @
Value: 185.199.108.153

For subdomains (app.example.com):

Type: CNAME
Name: app
Value: your-app.easydeploy.com

SSL Certificate

SSL certificates are automatically provisioned and renewed:

Automatic SSL: Free Let’s Encrypt certificates
Custom SSL: Upload your own certificates (Pro plan)
Wildcard SSL: Covers all subdomains (Enterprise plan)

Domain Types

Root Domains

example.com
mysite.org
company.net

Subdomains

app.example.com
api.mysite.org
blog.company.net

Wildcard Domains (Enterprise)

*.example.com (matches any subdomain)
Automatically secure new subdomains
Perfect for multi-tenant applications

DNS Configuration

Popular DNS Providers

Cloudflare

Type: CNAME
Name: your-subdomain
Content: your-app.easydeploy.com
Proxy status: DNS only (gray cloud)

Namecheap

Type: CNAME Record
Host: your-subdomain
Value: your-app.easydeploy.com
TTL: Automatic

GoDaddy

Type: CNAME
Name: your-subdomain
Value: your-app.easydeploy.com
TTL: 1 Hour

AWS Route 53

Type: CNAME
Name: your-subdomain
Value: your-app.easydeploy.com
TTL: 300

Verification

After updating DNS records, verification typically takes:

CNAME records: 5-10 minutes
A records: 15-30 minutes
Global propagation: Up to 48 hours

Check DNS propagation: whatsmydns.net

SSL Certificates

Automatic SSL (Free)

Let’s Encrypt certificates automatically provisioned
90-day validity with automatic renewal
Domain validation via HTTP-01 challenge
Multiple domains supported per certificate

Custom SSL (Pro Plan)

Upload your own SSL certificates:

Navigate to Settings → SSL
Click “Upload Custom Certificate”
Provide:
- Certificate file (.crt or .pem)
- Private key file (.key)
- Certificate chain (if applicable)

Wildcard SSL (Enterprise)

Covers all subdomains automatically
Simplified certificate management
Perfect for multi-tenant applications

Advanced Configuration

CNAME Flattening

Some DNS providers offer CNAME flattening for root domains:

Cloudflare: Automatic CNAME flattening
AWS Route 53: ALIAS records
Azure DNS: ALIAS records

CDN Integration

Easy Deploy includes global CDN:

Edge locations: 200+ worldwide
Cache optimization: Automatic asset caching
Performance: Faster page loads globally
DDoS protection: Built-in security

Redirects

Set up domain redirects:

WWW Redirect

Redirect www.example.com to example.com:

redirects:
  - from: "www.example.com"
    to: "example.com"
    status: 301

HTTPS Redirect

Force HTTPS for all traffic:

redirects:
  - from: "http://example.com/*"
    to: "https://example.com/:splat"
    status: 301

Domain Management

Multiple Domains

Connect multiple domains to the same application:

Primary domain: Main domain for your app
Alias domains: Additional domains that redirect
Branch domains: Different domains for different environments

Environment Domains

Use different domains for different environments:

Production: myapp.com
Staging: staging.myapp.com
Development: dev.myapp.com

Domain Transfer

Transfer domains between applications:

Remove domain from current application
Add domain to new application
Update DNS records if needed

API Management

Add Domain via API

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "myapp.com",
    "ssl": true
  }' \
  https://api.easydeploy.com/v1/applications/APP_ID/domains

Get Domain Status

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.easydeploy.com/v1/applications/APP_ID/domains

Update SSL Settings

curl -X PUT \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ssl_enabled": true,
    "force_https": true
  }' \
  https://api.easydeploy.com/v1/applications/APP_ID/domains/DOMAIN_ID

Troubleshooting

Common Issues

Domain not resolving

Check DNS record configuration
Verify TTL settings and wait for propagation
Use DNS lookup tools to verify records

SSL certificate not working

Ensure domain is properly verified
Check that domain points to Easy Deploy
Wait up to 24 hours for certificate provisioning

Mixed content warnings

Update hardcoded HTTP links to HTTPS
Use relative URLs for assets
Check third-party integrations

DNS Checker Tools

SSL Checker Tools

Need help? Check our troubleshooting guide or contact support.