# How to Integrate Custom DNS with DigitalPlat FreeDomain Domains

> Integrate custom DNS with DigitalPlat FreeDomain domains by delegating to external nameservers via the Domain Settings dashboard. Manage records with Cloudflare FreeDNS or BIND.

- Repository: [DigitalPlat Foundation/FreeDomain](https://github.com/DigitalPlatDev/FreeDomain)
- Tags: how-to-guide
- Published: 2026-02-25

---

**You can integrate custom DNS with DigitalPlat FreeDomain by delegating authority to external nameservers through the Domain Settings dashboard, allowing you to manage DNS records through any provider like Cloudflare, FreeDNS, or self-hosted BIND servers.**

DigitalPlat FreeDomain is an open-source initiative from the [DigitalPlatDev/FreeDomain](https://github.com/DigitalPlatDev/FreeDomain) repository that provides completely free domain names under the `dpdns.org` zone. When you integrate custom DNS with DigitalPlat FreeDomain domains, you replace the default DigitalPlat nameservers with your preferred DNS provider's nameservers, delegating full DNS authority without requiring platform-specific APIs or integration libraries.

## Understanding the DNS Delegation Architecture

DigitalPlat FreeDomain operates on a standard DNS delegation model defined in the platform's documentation. When you claim a domain such as `example.dpdns.org`, the system initially assigns default DigitalPlat nameservers. To integrate custom DNS, you configure your domain to use external nameservers, which instructs the global DNS system to query your chosen provider for all records related to your domain.

This approach is implemented in [`documents/tutorial/getting-started/1.2-dns-hosting.md`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/documents/tutorial/getting-started/1.2-dns-hosting.md), which outlines the specific steps for replacing default nameservers with custom ones.

## Step-by-Step Custom DNS Integration

### Claim Your Free Domain

First, create a DigitalPlat account and register your free domain through the dashboard. The system automatically creates the domain under the `dpdns.org` zone and displays the current default nameservers assigned by DigitalPlat.

### Select a DNS Hosting Provider

Choose any DNS provider that supports custom nameserver configuration. The DigitalPlat tutorial recommends **Cloudflare** for its free tier and rapid propagation, but you can also use **FreeDNS**, **Hostry**, or self-hosted solutions like **BIND** or **PowerDNS**.

### Configure Nameserver Delegation

Add your domain to your chosen DNS provider. The provider will supply two or more nameserver addresses, such as `alice.ns.cloudflare.com` and `bob.ns.cloudflare.com` as documented in [`documents/tutorial/getting-started/1.2-dns-hosting.md`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/documents/tutorial/getting-started/1.2-dns-hosting.md) lines 55-60.

In the DigitalPlat dashboard, navigate to **Domain Settings → Nameservers** and replace the default DigitalPlat nameservers with the ones provided by your DNS host. This step is illustrated in the tutorial at lines 62-66.

### Verify DNS Propagation

After updating the nameservers, wait for global DNS propagation. According to the documentation at lines 72-76, this typically takes a few minutes but can extend up to 24 hours in rare cases. Your DNS provider's dashboard will display an **Active** status once propagation completes.

### Manage DNS Records

Once active, create DNS records (A, AAAA, CNAME, TXT, MX) through your provider's interface. As noted in lines 80-92 of the tutorial, Cloudflare propagates these changes within seconds, allowing immediate use of your free domain for websites, APIs, or email services.

## Automating Domain Verification with WHOIS

While DigitalPlat FreeDomain does not expose a public API for DNS management, the repository includes a WHOIS server implementation at [`opensource/whois_server/whois.py`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/opensource/whois_server/whois.py) that you can query to verify domain registration and current nameserver configuration.

Use the following Python script to check your domain status programmatically:

```python
import socket

def whois_query(domain: str) -> str:
    """Send a WHOIS request to the DigitalPlat WHOIS server."""
    HOST, PORT = "whois.digitalplat.org", 43
    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
        s.connect((HOST, PORT))
        s.sendall((domain + "\r\n").encode())
        response = s.recv(4096).decode()
    return response

# Check registration and nameserver configuration

print(whois_query("example.dpdns.org"))

```

This queries the public WHOIS endpoint at `whois.digitalplat.org:43` and returns registration details including the current nameserver delegation, useful for automation scripts that need to verify DNS configuration changes.

## Summary

- DigitalPlat FreeDomain provides free domains under `dpdns.org` that support full DNS delegation to external providers.
- **Integrate custom DNS** by replacing default DigitalPlat nameservers with those from your chosen provider (Cloudflare, FreeDNS, BIND, etc.) via the dashboard at **Domain Settings → Nameservers**.
- Documentation in [`documents/tutorial/getting-started/1.2-dns-hosting.md`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/documents/tutorial/getting-started/1.2-dns-hosting.md) provides specific UI guidance and Cloudflare configuration examples.
- Verify delegation using the built-in WHOIS server at `whois.digitalplat.org` or the Python implementation in [`opensource/whois_server/whois.py`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/opensource/whois_server/whois.py).
- No platform-specific API is required; standard DNS delegation enables immediate use for websites, email, and applications.

## Frequently Asked Questions

### Can I use any DNS provider with DigitalPlat FreeDomain?

Yes. DigitalPlat FreeDomain supports standard DNS delegation, meaning you can use any provider that offers custom nameserver configuration, including Cloudflare, FreeDNS, Hostry, or self-hosted solutions like BIND and PowerDNS. The platform does not restrict you to specific DNS vendors.

### How long does DNS propagation take when changing nameservers?

According to the DigitalPlat tutorial at [`documents/tutorial/getting-started/1.2-dns-hosting.md`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/documents/tutorial/getting-started/1.2-dns-hosting.md), propagation typically completes within a few minutes but can take up to 24 hours in rare cases depending on global DNS cache behavior. Cloudflare and similar modern providers usually activate domains within minutes.

### Is there a public API for automated DNS management?

No. DigitalPlat FreeDomain does not expose a public API for DNS record management or nameserver changes. All configuration is performed through the web dashboard. However, the repository includes a WHOIS server implementation at [`opensource/whois_server/whois.py`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/opensource/whois_server/whois.py) that you can query to verify domain registration and current nameserver configuration programmatically.

### Where can I find the official DNS hosting tutorial?

The complete step-by-step guide is located at [`documents/tutorial/getting-started/1.2-dns-hosting.md`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/documents/tutorial/getting-started/1.2-dns-hosting.md) in the DigitalPlatDev/FreeDomain repository. This document includes specific instructions for Cloudflare integration, UI screenshot references at lines 62-66, and troubleshooting tips for nameserver delegation.