From 51b50565d19a4f6f7d8c54523cadab1af1371893 Mon Sep 17 00:00:00 2001 From: Tom Limoncelli Date: Thu, 24 Jul 2025 14:57:56 -0400 Subject: [PATCH] Add docs --- documentation/getting-started/getting-started.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/documentation/getting-started/getting-started.md b/documentation/getting-started/getting-started.md index 5cc2596b4..0a7b54cfd 100644 --- a/documentation/getting-started/getting-started.md +++ b/documentation/getting-started/getting-started.md @@ -134,16 +134,23 @@ like [git-crypt](https://www.agwa.name/projects/git-crypt) or There are 2 types of providers: -A "Registrar" is with whom you register the domain. Start with +* A "Registrar" is with whom you register the domain. Start with `NONE`, which is a provider that never talks to or updates the registrar. You can define your registrar later when you want to use advanced features. -A "DnsProvider" is the service that actually provides DNS service +* A "DnsProvider" is the service that actually provides DNS service (port 53) and may be the same or a different registrar. Even if both your Registrar and DnsProvider are the same company, two different definitions must be included in `dnsconfig.js`. +{% hint style="warning" %} +**WARNING:** Here's a point that confuses many new DNSControl users. Even if a +provider is both a "registrar" and a DNS Provider", it still needs to be +defined twice. For example, if you use NAMEDOTCOM as both your registrar and +DNS provider, you'll define a `REG_NAMEDOTCOM` and `DNS_NAMEDOTCOM`. However it +only needs to be defined in `creds.json` once. +{% endhint %} ## 4. Create the initial `creds.json`