Custom Domain

Custom Domain Setup Guide

Overview

This guide walks you through connecting your custom domain to your Emergent deployment. We offer two methods: Automatic Configuration with Auto-Link(recommended) and Manual DNS Configuration.

Prerequisites

• An active Emergent deployment

• A custom domain purchased from any domain provider (GoDaddy, Namecheap, Cloudflare, SquareSpace, etc.)

• Access to the email account used to purchase your domain

Method 1: Automatic Setup with Auto-Link(Recommended)

New Feature! Auto-Link automatically configures DNS records with your domain provider—no manual setup required.

Step-by-Step Process

Benefits of Auto-Link Method

Method 2: Manual DNS Configuration (Alternative)

If automatic configuration isn't available for your domain provider, you can set up DNS records manually.

Step 1: Initiate Manual Setup

Step 2: Get DNS Configuration Details

After entering your domain, Emergent will provide you with DNS configuration details if you:

Required DNS Record:

Step 3: Add DNS Records to Your Provider

For Cloudflare

 1. Log into Cloudflare dashboard
 2. Select your domain
 3. Go to DNS → Records
 4. Click "Add record"
 5. Select "A" or "CNAME" as type
 6. Enter "@" or "www" in host
 7. Enter IP addresses `162.159.142.117` or `172.66.2.113`, or enter `your domain` in case of CNAME
 8. Set Proxy status to "DNS only" (gray cloud)
 9. Click "Save"
 10. Repeat steps 4 to 9 for all records in the table above

For GoDaddy

 1. Log into GoDaddy account
 2. Go to My Products → DNS
 3. Find your domain and click "Manage"
 4. Click "Add" in the Records section
 5. Select "A" or "CNAME" as type
 6. Enter "@" or "www" in host
 7. Enter IP addresses `162.159.142.117` or `172.66.2.113`, or enter `your domain` in case of CNAME
 8. Click "Save"
 9. Repeat steps 4 to 8 for all records in the table above

For Namecheap

 1. Log into Namecheap account
 2. Go to Domain List
 3. Click "Manage" next to your domain
 4. Go to Advanced DNS tab
 5. Click "Add New Record"
 6. Select "A Record" or "CNAME record"
 7. Enter "@" or "www" in host
 8. Enter IP addresses `162.159.142.117` or `172.66.2.113`, or enter `your domain` in case of CNAME
 9. Click the checkmark to save
10. Repeat steps 4 to 9 for all records in the table above

Step 4: Verify Domain Ownership

Troubleshooting

Domain verification is taking too long

• DNS propagation can take up to 48 hours in some cases, though it's usually much faster. Try:

• Waiting 15-30 minutes and checking again

• Verifying your DNS records are correctly configured

• Ensuring there are no conflicting records

Auto-Link doesn't support my domain provider

• If your domain provider isn't supported by Auto-Link, use the Manual DNS Configuration method instead. Most major providers are supported, but some smaller or regional providers may require manual setup.

I'm seeing a 'Record already exists' error

• You may have an existing A record for the same subdomain. Delete or modify the existing record before adding the new one pointing to Emergent's IP address.

My domain shows as verified but the site isn't loading

• Ensure your Emergent deployment is active and running

• Clear your browser cache

• Try accessing from a different browser or device

• Wait a few more minutes for full propagation

Quick Reference

Automatic Setup (Auto-Link)

• When: Domain provider is supported by Auto-Link

• Time: Under 5 minutes

• Difficulty: Easy

• Use for: Most users (recommended)

Manual DNS Configuration

• When: Auto-Link doesn't support your provider

• Time: 5-15 minutes (plus propagation)

• Difficulty: Moderate

• Use for: Unsupported providers or advanced users

Remember

✅ Auto-Link is easiest - Use automatic setup when available

✅ DNS takes time - Propagation can take 5-15 minutes (sometimes longer)

✅ Check your records - Verify IP addresses are correct: 162.159.142.117 and 172.66.2.113 plus www CNAME record is pointing to the domain you are trying to link to your website

✅ One domain per deployment - Each custom domain links to one deployment

❌ Don't use proxy initially - For Cloudflare, start with "DNS only" mode