Atlas E74243keac
Help Center›Deployments and Custom Domains›Deployments and Custom Domains
Table of contents
  • Overview
  • Prerequisites
  • Step 1: Initiate Custom Domain Setup
  • Step 2: If you choose to proceed manually
  • Step 4: Add DNS Records to Your Provider
  • For Popular DNS Providers:
  • Step 5: Verify Domain Ownership
  • Step 6: Complete Setup
  • Important Notes
  • DNS Propagation
  • Critical Requirements
  • Troubleshooting
  • Security Best Practices
  • Support
    • Related articles

    Deployments and Custom Domains

    Last updated December 23, 2025

    Overview

    This guide walks you through connecting your custom domain to your Emergent deployment. The process involves adding DNS records to verify domain ownership and direct traffic to your application.

    Prerequisites

    • An active Emergent deployment
    • Access to your domain's DNS management panel
    • Your domain registrar login credentials (GoDaddy, Namecheap, Cloudflare, etc.)

    Step-by-Step Process

    Step 1: Initiate Custom Domain Setup

    1. Navigate to your Deployments section in Emergent
    2. Find the Custom Domain section
    3. Click "Link Domain" button
    4. Enter your domain name (e.g., emergent1.feelingcoding.xyz)
    5. Click "Auto-Link" / "Link- Manually"

    Step 2: If you choose to proceed manually

    You need to upload the following details:

    Required DNS Record:

    1. Record 1 Type: A Name: www Value: 162.159.142.117 TTL: 3600
    2. Record 2 Type: A Name: www Value: 172.66.2.113 TTL: 3600
    3. For CNAME Type: CNAME Name: www Value: @ TTL: 3600

    Step 3: If you choose to proceed with Auto - Link - You will see a pop-up indicating that Emergent uses Entri to configure the domain. - Click on Continue. - Click on Authorize with [Your Service Provider]. - You will be redirected to your domain service provider's page, where you need upload your credentials. - Wait for a moment, and then check your status; it should be marked as "Verified".

    Step 4: Add DNS Records to Your Provider

    Cloudflare:

    1. Log into Cloudflare dashboard
    2. Select your domain
    3. Go to DNS → Records
    4. Click "Add record"
    5. Select "A" as type
    6. Enter subdomain name (e.g., "emergent1")
    7. Enter the IP address: 162.159.142.117 and 172.66.2.113
    8. Set Proxy status to "DNS only" (gray cloud)
    9. Click "Save"

    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" record type
    6. Enter Host (subdomain name)
    7. Enter the IP address
    8. Click "Save"

    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"
    7. Enter Host and IP address
    8. Click the checkmark to save

    Step 5: Verify Domain Ownership

    1. After adding the DNS record, return to Emergent
    2. Click "Refresh Status" button
    3. Wait for verification (5–15 minutes)
    4. Once verified, you'll see a green "Verified" status
    Deployments and Custom Domains

    Step 6: Complete Setup

    • Your custom domain is now active
    • You can visit your application using your custom domain
    • The domain will automatically point to your live deployment

    Important Notes

    DNS Propagation

    • DNS changes typically take 5–15 minutes to propagate
    • In some cases, global propagation may take up to 24 hours
    • Use online DNS checker tools to verify propagation status

    Critical Requirements

    ⚠️ Important: Ensure TWO A record points to your domain

    • Do not add multiple IP addresses for the same subdomain
    • Remove any conflicting DNS records before adding the Emergent record
    • Multiple A records can cause routing issues

    Troubleshooting

    Domain Not Verifying:

    • Double-check the DNS record values
    • Ensure TTL is set to 300 seconds or lower
    • Wait 15–30 minutes and try again
    • Use DNS lookup tools to verify the record exists

    SSL Certificate Issues:

    • SSL certificates are automatically provisioned
    • Allow 5–10 minutes after verification for SSL setup
    • If issues persist, contact support

    Domain Not Loading:

    • Verify the A records is correctly configured
    • Check that no other A records conflict
    • Ensure the domain is verified in Emergent
    • Try accessing via incognito/private browsing mode

    Security Best Practices

    1. Keep DNS Records Minimal: Only add necessary records
    2. Monitor Domain Status: Regularly check domain verification status
    3. Use Strong DNS Provider: Choose reputable DNS providers
    4. Enable Domain Lock: Prevent unauthorized domain transfers

    Support

    If you encounter issues during setup:

    1. Verify all DNS records are correctly configured
    2. Wait for DNS propagation (up to 24 hours)
    3. Check our troubleshooting section above
    4. Contact Emergent support with:
    • Your domain name
    • Screenshots of DNS configuration
    • Error messages (if any)

    Deployment Time: Custom domain setup typically takes 5–15 minutes after DNS propagation.

    Remember: Always ensure two IP addresses points to your domain to avoid routing conflicts.

    For any questions or assistance, feel free to email us at  support@emergent.sh 

    Was this article helpful?