Atlas E74243keacEmergent
Help Center›The Deployment Manual›Deployments and Custom Domains
Table of contents
  • Overview
  • Prerequisites
  • Step-by-Step Process
  • Step 1: Initiate Custom Domain Setup
  • Step 2: Configure DNS Records
  • Step 3: Add DNS Records to Your Provider
  • For Popular DNS Providers:
  • Step 4: Verify Domain Ownership
  • Step 5: Complete Setup
  • Important Notes
  • DNS Propagation
  • Critical Requirements
  • Troubleshooting
  • DNS Configuration Examples
  • Example 1: Subdomain Setup
  • Security Best Practices
  • Support
    • Related articles

    Deployments and Custom Domains

    Last updated July 1, 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 "Next"

    Step 2: Configure DNS Records

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

    Required DNS Record:

    • Type: A Record
    • Host/Name: emergent1 (or your chosen subdomain)
    • Value/Points to: 34.57.15.54 (IP address provided by Emergent)
    • TTL: 300 seconds (or leave as default)

    Step 3: 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: 34.57.15.54
    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 4: Verify Domain Ownership

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

    Step 5: 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 only ONE 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 record is correctly configured
    • Check that no other A records conflict
    • Ensure the domain is verified in Emergent
    • Try accessing via incognito/private browsing mode

    DNS Configuration Examples

    Example 1: Subdomain Setup

    Type: A
Host: app
Value: 34.57.15.54
Result: app.yourdomain.com → Your Emergent App

    Example 2: Root Domain Setup

    Type: A
Host: @ (or leave empty)
Value: 34.57.15.54
Result: yourdomain.com → Your Emergent App

    Example 3: Multiple Subdomains

    Type: A
Host: staging
Value: 34.57.15.54

Type: A
Host: prod
Value: 34.57.15.54

    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 only one IP address 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?