# DigitalPlat FreeDomain DNS Integration with FreeDNS by Afraid.org: Complete Setup Guide

> Easily integrate DigitalPlat FreeDomain with FreeDNS by Afraid.org. Our guide shows you how to set up nameserver delegation for your free .dpdns.org domain quickly and efficiently.

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

---

**Yes, DigitalPlat FreeDomain fully supports DNS integration with FreeDNS by Afraid.org through standard nameserver delegation, allowing you to point your free .dpdns.org domain to Afraid.org's DNS infrastructure immediately after registration.**

DigitalPlat FreeDomain is an open-source domain registration platform hosted at **DigitalPlatDev/FreeDomain** that provides free subdomain registration under the .dpdns.org zone. The platform implements a provider-agnostic DNS architecture that explicitly lists **FreeDNS by Afraid.org** as a supported third-party DNS provider in its official documentation, enabling seamless integration without requiring proprietary API connections.

## How DigitalPlat FreeDomain Supports FreeDNS Integration

The integration between DigitalPlat FreeDomain and FreeDNS by Afraid.org relies on standard DNS delegation principles rather than custom API integrations. This architectural decision ensures compatibility with any DNS provider that supports custom nameserver assignments.

### Provider-Agnostic DNS Architecture

According to the source code analysis, DigitalPlat FreeDomain treats nameserver values as **opaque strings**, storing whatever values the user provides without validating against a specific provider's API. This design means you can configure any standard DNS service—including FreeDNS by Afraid.org—by simply entering the provider's nameserver hostnames.

The backend logic follows this pattern:

```python
def update_nameservers(domain, ns1, ns2=None):
    # Store NS values in the domain record

    zone = get_zone(domain)
    zone.ns = [ns1] + ([ns2] if ns2 else [])
    save_zone(zone)

```

### Official Documentation References

The **README.md** file in the DigitalPlatDev/FreeDomain repository explicitly lists FreeDNS by Afraid.org as a supported DNS provider at line 9. Additionally, the tutorial documentation 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) mentions FreeDNS among alternative DNS providers, confirming first-class support for this integration.

## Step-by-Step FreeDNS Configuration

Integrating your DigitalPlat FreeDomain with FreeDNS by Afraid.org requires obtaining the correct nameserver addresses from Afraid.org and configuring them in the DigitalPlat interface.

### Obtaining FreeDNS Nameservers

Before configuring DigitalPlat, you must set up your domain within the FreeDNS by Afraid.org control panel. Once configured, Afraid.org provides standard nameserver hostnames—typically `ns1.afraid.org`, `ns2.afraid.org`, and additional secondary servers. Record these values for the next step.

### Configuring NS Records in DigitalPlat

The DigitalPlat FreeDomain interface provides dedicated form fields for nameserver configuration during registration and domain management.

During initial registration, the [`domainreg_check.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/domainreg_check.html) template renders the following input fields at lines 103-104:

```html
<label for="ns1" class="block text-gray-700 font-bold mb-2">
  <span class="text-red-500">*</span> Name Server 1
</label>
<input type="text" name="ns1" id="ns1"
       class="shadow appearance-none border rounded w-full py-2 px-3 text-gray-700 leading-tight focus:outline-none focus:shadow-outline"
       placeholder="NS1" required>

```

For existing domains, the [`domain_view.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/domain_view.html) template provides similar fields at lines 150-151, allowing you to update nameservers post-registration.

To complete the FreeDNS integration:

1. Enter `ns1.afraid.org` in the **Name Server 1** field
2. Enter `ns2.afraid.org` in the **Name Server 2** field (if available)
3. Save the configuration

## Key Implementation Files

The following source files in the DigitalPlatDev/FreeDomain repository govern the FreeDNS integration capability:

| File | Purpose |
|------|---------|
| [`README.md`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/README.md) | Explicitly lists FreeDNS by Afraid.org as a supported provider at line 9 |
| [`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) | Documents FreeDNS as an alternative DNS hosting option |
| [`opensource/frontend/domainreg_check.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/opensource/frontend/domainreg_check.html) | Renders NS input fields during domain registration (lines 103-104) |
| [`opensource/frontend/domain_view.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/opensource/frontend/domain_view.html) | Provides NS record editing for existing domains (lines 150-151) |
| [`opensource/frontend/pay_success.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/opensource/frontend/pay_success.html) | Displays DNS propagation timing expectations (line 55) |

## DNS Propagation and Verification

After configuring FreeDNS nameservers in the DigitalPlat interface, the platform updates the zone file immediately. However, global DNS propagation requires time for recursive resolvers to cache the new NS records.

According to [`pay_success.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/pay_success.html) at line 55, DigitalPlat indicates that DNS changes typically propagate **within minutes, though the process may take up to 20 minutes** in some cases. You can verify successful delegation using standard DNS lookup tools:

```bash
dig NS yourdomain.dpdns.org

```

The output should display the Afraid.org nameservers you configured (e.g., `ns1.afraid.org`, `ns2.afraid.org`).

## Summary

- **DigitalPlat FreeDomain** explicitly supports **FreeDNS by Afraid.org** as a third-party DNS provider through standard nameserver delegation.
- The integration requires no proprietary API; simply configure the **NS records** in the DigitalPlat UI to point to Afraid.org's nameservers (e.g., `ns1.afraid.org`).
- Key files governing this functionality include [`README.md`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/README.md) (provider listing), [`domainreg_check.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/domainreg_check.html) (registration UI), and [`domain_view.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/domain_view.html) (management UI).
- DNS propagation typically completes within minutes but may take up to 20 minutes according to the platform's payment success documentation.

## Frequently Asked Questions

### How do I connect my DigitalPlat FreeDomain to FreeDNS by Afraid.org?

To connect your domain, first obtain the nameserver addresses from your FreeDNS by Afraid.org control panel (typically `ns1.afraid.org` and `ns2.afraid.org`). Then, log into your DigitalPlat FreeDomain account and enter these values into the **Name Server 1** and **Name Server 2** fields during registration or via the domain management page. Save the configuration to complete the delegation.

### Does DigitalPlat FreeDomain require an API key from Afraid.org?

No API key is required. DigitalPlat FreeDomain uses **standard DNS delegation** through NS records rather than proprietary API integration. The platform treats nameserver values as opaque strings, meaning you only need to provide the hostnames that Afraid.org assigns to your domain (such as `ns1.afraid.org`).

### How long does DNS propagation take when switching to FreeDNS?

According to the [`pay_success.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/pay_success.html) template in the DigitalPlat source code, DNS changes typically propagate **within minutes**, though the process may take up to **20 minutes** in some cases. You can verify completion by running `dig NS yourdomain.dpdns.org` and confirming the output shows the Afraid.org nameservers.

### Can I change my DNS provider to FreeDNS after initial registration?

Yes, you can update your nameservers at any time after registration. The [`domain_view.html`](https://github.com/DigitalPlatDev/FreeDomain/blob/main/domain_view.html) template provides form fields for editing NS records on existing domains (lines 150-151). Simply navigate to your domain management page, replace the current nameserver values with your FreeDNS nameservers (e.g., `ns1.afraid.org`), and save the changes to trigger a new DNS delegation.