# DNS Setup Guide

## Prerequisites

Before you begin:

1. **Domain Ownership**: You must control the domain's DNS settings (via registrar/Cloudflare etc.)
2. **Deployed Project**: Have a live 4EVERLAND project (IPFS/IC/Arweave) ready for custom domain mapping
3. **DNS Knowledge**: Basic understanding of CNAME/TXT records (we provide copy-paste values)

##  Step 1: Add Custom Domain in 4EVERLAND

**Path**: Dashboard → Projects → \[Select Project] → View Detail → **Domains** → **Add Custom Domain**

1. **Domain Selection**
   * Enter your domain (e.g., `yourproject.com` or `www.yourproject.com`)
   * Click the "Add" button 
2. **Add Domains**
   * Check Add `www.yourproject.com` and redirect `yourproject.com` to it / Add `yourproject.com` and redirect  `www.yourproject.com` to it
   * Click **OK** → 4EVERLAND generates unique DNS records for verification

<figure><img src="https://4107147272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVHC4TEQKrh3Bfvq5dDi%2Fuploads%2FQc0UIg588IDf2mv5hj31%2Fpostspark_export_2025-04-25_18-01-28.jpeg?alt=media&#x26;token=0d095a9e-0a04-4493-abc0-2909522680c8" alt=""><figcaption><p>Add Custom Domian in 4EVERLAN</p></figcaption></figure>

## Step 2: Configure DNS Records (Critical Step)

### DNS Provider Setup (Example: Cloudflare)

* Login to your DNS provider (Cloudflare/GoDaddy/Namecheap etc.)
* Add records:

| Record Type | Name     | Value                                | TTL |
| ----------- | -------- | ------------------------------------ | --- |
| CNAME       | @ or www | `your-project-id.cname.ddnsweb3.com` | 1h  |
| TXT         | @        | `dns.verify=your-project-id`         | 1h  |

<figure><img src="https://4107147272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVHC4TEQKrh3Bfvq5dDi%2Fuploads%2F7MWiIIEg8KcgEPkUa0bP%2Fpostspark_export_2025-04-16_17-36-09.jpeg?alt=media&#x26;token=fd3fc246-0bc0-4951-b01a-2c18378a7e2f" alt=""><figcaption></figcaption></figure>

## Step 3: Verify Domain Propagation

1. **Check Propagation**
   * Wait 5-30 minutes (DNS propagation time varies by provider)
   * Test with: `dig +short CNAME yourdomain.com` (should return 4EVERLAND target)
   * Use [DNS Checker](https://dnschecker.org/) for global propagation status
2. **Confirm in 4EVERLAND**
   * Return to the domain modal → Click **Refresh**
   * *Success*: Status changes to **Verified ✅**; project auto-deploys to custom domain
   * *Failed?*:
     * ❌ CNAME mismatch → Recheck record values
     * ❌ TXT missing → Ensure subdomain exists
     * ⏱️ Wait 10 more minutes (propagation delays common with new domains)

<figure><img src="https://4107147272-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEVHC4TEQKrh3Bfvq5dDi%2Fuploads%2Fj2Vc082hs4VLzEreeO6h%2Fpostspark_export_2025-04-16_17-30-47.jpeg?alt=media&#x26;token=f7ff0339-2484-4497-a0d7-8c9d59373fee" alt=""><figcaption></figcaption></figure>

## SSL Certificate Management

4EVERLAND ensures secure HTTPS access for all custom domains with fully automated SSL/TLS certificate management. Below is a detailed breakdown of our certificate system, designed for seamless integration and zero manual configuration—mirroring industry standards set by leaders like Vercel and Cloudflare.

## Troubleshooting Common Issues

| Issue                  | Solution                                                                        |
| ---------------------- | ------------------------------------------------------------------------------- |
| Domain shows "Pending" | Double-check CNAME/TXT records, ensure that the proxy is disabled on Cloudflare |

{% hint style="info" %}

### 📞 Support Resources

* **Live Chat**: Join [Discord server](https://discord.com/invite/Cun2VpsdjF) → #Open a ticket
* **Email**: <contact@4everland.org> (include domain name & project ID in subject)
  {% endhint %}