> 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.4everland.org/hositng/guides/domain-management/dns-setup-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.