> For the complete documentation index, see [llms.txt](https://docs.4everland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.4everland.org/hositng/guides/domain-management/dns-setup-guide.md).

# 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="/files/qUIBdrwAlwLC5qJQLbEy" 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="/files/uQahLZypVCZxfGVG5omk" 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="/files/oCyTT61etXOS3Fq49fiu" 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 %}