DNS Configuration with DigitalPlat FreeDomain: Complete Setup Guide

Configure your DigitalPlat FreeDomain by pointing its authoritative nameservers to Cloudflare (or any standard DNS provider), then manage A, CNAME, and TXT records through your chosen provider’s dashboard.

DigitalPlat FreeDomain allows you to attach custom domains to the platform by configuring external DNS hosting. This guide walks you through the complete DNS configuration with DigitalPlat FreeDomain using Cloudflare as the recommended provider, based on the official documentation in the DigitalPlatDev/FreeDomain repository.

Prerequisites

Before starting DNS configuration, you must have an active DigitalPlat account and a registered domain within the platform. Account creation steps are documented in documents/tutorial/getting-started/1.1-register-account.md.

Step-by-Step DNS Configuration Process

1. Select a DNS Provider

DigitalPlat FreeDomain works with any standard DNS provider that supports custom authoritative nameservers. The official tutorial recommends Cloudflare for its free tier, reliability, and beginner-friendly interface, as noted in documents/tutorial/getting-started/1.2-dns-hosting.md.

2. Create Your Cloudflare Account

Visit the Cloudflare sign-up page and register using a valid email address. Verify your email to activate the account.

3. Add Your Domain to Cloudflare

After logging in:

  1. Click Add a site.
  2. Enter your DigitalPlat domain (e.g., example.dpdns.org).
  3. Click Continue.

This step is detailed in documents/tutorial/getting-started/1.2-dns-hosting.md at lines 34-41.

4. Choose the Free Plan

Select the Free tier when prompted. This plan includes all necessary DNS management features without cost.

5. Update Nameservers in DigitalPlat Dashboard

Cloudflare will assign two unique nameserver hostnames (e.g., alice.ns.cloudflare.com and bob.ns.cloudflare.com).

To apply them:

  1. Open the DigitalPlat dashboard.
  2. Navigate to Domain SettingsNameservers.
  3. Replace the existing nameserver entries with the two Cloudflare values.
  4. Save the changes.

This critical step is documented in documents/tutorial/getting-started/1.2-dns-hosting.md at lines 55-68.

6. Wait for DNS Propagation

Nameserver changes typically propagate within minutes but can take up to 24 hours to fully resolve globally.

7. Verify Active Status

In the Cloudflare dashboard, your domain status will change to Active once the nameserver update is detected. This confirms successful DNS configuration with DigitalPlat FreeDomain.

8. Configure DNS Records

Navigate to DNS → Records in Cloudflare to create the records required for your services:


# Example A record (IPv4 address)

Type: A
Name: @              # root domain

Value: 203.0.113.42  # your server IP

TTL: Auto
Proxy status: DNS only   # or "Proxied" for Cloudflare CDN

# Example CNAME record (sub-domain)

Type: CNAME
Name: www
Value: example.dpdns.org
TTL: Auto
Proxy status: DNS only

For SSL verification or email services, add TXT records:

Type: TXT
Name: _acme-challenge
Value: "random-token-provided-by-your-CA"
TTL: Auto

These examples are derived from the configuration samples in documents/tutorial/getting-started/1.2-dns-hosting.md.

9. Use Alternative DNS Providers (Optional)

If you prefer a different provider, simply obtain their custom nameserver addresses and enter them in the DigitalPlat Domain SettingsNameservers section instead of Cloudflare’s. This flexibility is documented in documents/domains/faq.md.

Key Documentation References

File Purpose Location
documents/tutorial/getting-started/1.2-dns-hosting.md Complete DNS hosting tutorial and nameserver configuration View source
documents/tutorial/getting-started/1.1-register-account.md Account registration prerequisites View source
documents/domains/faq.md Alternative DNS providers and troubleshooting View source
README.md Platform overview and capabilities View source

Summary

  • DNS configuration with DigitalPlat FreeDomain requires pointing your domain's authoritative nameservers to an external DNS provider like Cloudflare.
  • The critical step occurs in Domain Settings → Nameservers within the DigitalPlat dashboard, where you replace default nameservers with those provided by your DNS host.
  • Cloudflare is the recommended provider, offering a free tier with full DNS management capabilities documented in documents/tutorial/getting-started/1.2-dns-hosting.md.
  • After nameserver updates, create A, CNAME, and TXT records in your DNS provider’s dashboard to point your domain to your servers or services.
  • DNS propagation typically completes within minutes but can require up to 24 hours to resolve globally.

Frequently Asked Questions

Can I use a DNS provider other than Cloudflare with DigitalPlat FreeDomain?

Yes. DigitalPlat FreeDomain works with any standard DNS provider that supports custom authoritative nameservers. Simply obtain the nameserver addresses from your preferred provider (such as Google Cloud DNS, AWS Route 53, or Namecheap) and enter them in the DigitalPlat dashboard under Domain Settings → Nameservers instead of Cloudflare’s values.

How long does DNS propagation take when configuring DigitalPlat FreeDomain?

Nameserver changes typically propagate within a few minutes, but the process can take up to 24 hours to fully resolve across all global DNS resolvers. You can verify completion by checking the domain status in your DNS provider’s dashboard (e.g., Cloudflare shows Active) or using command-line tools like dig or nslookup to query your domain’s authoritative nameservers.

Where do I find the nameserver settings in the DigitalPlat dashboard?

Navigate to your domain’s management page and select Domain Settings, then click the Nameservers subsection. This interface allows you to replace the default DigitalPlat nameservers with the custom values provided by your external DNS host. These steps are documented in documents/tutorial/getting-started/1.2-dns-hosting.md at lines 62-68.

What DNS record types are supported for DigitalPlat FreeDomain?

Since DigitalPlat FreeDomain delegates authoritative DNS control to your chosen provider, you can create any record type supported by that provider. Commonly used records include A (IPv4 addresses), AAAA (IPv6), CNAME (canonical names), MX (mail exchange), and TXT (verification and SPF). Configure these in your DNS provider’s dashboard (e.g., Cloudflare’s DNS → Records section) after completing the nameserver setup.

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →