Guides & documentation
Step-by-step guides for every PrimeDNS feature, from adding your first domain to split-horizon views, DNSSEC and team access.
-
Quick Start
Get PrimeDNS running in minutes: add a domain, create an API key, create your first DNS record, and verify it resolves.
-
ACME DNS-01 with acme.sh
Issue and renew Let's Encrypt certificates, including wildcards, with acme.sh and the PrimeDNS DNS-01 API plugin.
-
SPF, DKIM & DMARC Setup
Set up SPF, DKIM and DMARC using the built-in PrimeDNS wizards, and roll out DMARC enforcement safely.
-
Bulk Reverse DNS (PTR)
Create reverse DNS zones and bulk-generate PTR records via CSV import, CIDR sweep, or auto-generate from A/AAAA.
-
Split-Horizon Views
Answer DNS queries differently depending on client network — internal LAN vs. public internet — with PrimeDNS Split-Horizon Views.
-
Migrating from Cloudflare, Route53 or BIND
Export your existing DNS zone in standard BIND format and import it into PrimeDNS — no manual re-entry, no lock-in.
-
Webhooks & Alerts
Get notified in real time on DNS changes and resolver health via HMAC-signed webhooks and configurable alert rules.
-
Audit Log
Every DNS record change logged with who, when, from what IP, and the full before/after diff — filterable and exportable to CSV.
-
Observability
p95 latency, SERVFAIL/NXDOMAIN rates, top resolvers, geographic distribution and more — real-time DNS analytics built into PrimeDNS.
-
Team & RBAC
Invite teammates with role- and zone-scoped access — Admin, Billing, DNS Manager, DNS Viewer, Monitoring.
-
ACME DNS-01 certificates with PrimeDNS
Issue and renew Let's Encrypt certificates, including wildcards, with the PrimeDNS DNS-01 API. Works with acme.sh, certbot, cert-manager and any ACME client.
-
ACME DNS-01 with certbot
Issue and renew Let's Encrypt certificates, including wildcards, with certbot and two hook scripts for the PrimeDNS DNS-01 API.
-
cert-manager DNS-01 webhook for PrimeDNS
Issue certificates on Kubernetes with cert-manager and the PrimeDNS DNS-01 webhook: Helm chart, issuer and certificate examples, CNAME delegation.
-
Record Templates
Save a set of DNS records once and apply it to any zone in one step: ready-made templates for hosting and mail providers, your own templates, server profiles and the API.
-
Internationalised Domain Names (IDN)
Use domain names with non-ASCII letters: Unicode and punycode forms, records, certificates, and how look-alike (homograph) names are handled.
-
Webhook events
Reference for PrimeDNS webhooks: delivery headers, signature verification, retries, the event envelope and the data of every event.
-
Restricted Mode
What still works, what is refused and what the API returns (403 ACCOUNT_FROZEN) while an account has an unsettled balance. DNS keeps answering.
-
API changelog
What changed in the PrimeDNS API and when: added, changed and deprecated fields and operations, by version.
-
API error codes
Every error code the PrimeDNS API returns, with its HTTP status and meaning, the error body and the request id to quote to support.
-
ACME DNS-01 with lego
Issue and renew Let's Encrypt certificates, including wildcards, with lego (and Traefik) and the PrimeDNS DNS provider: staging test, key file, renewal with a deploy hook.
-
Dynamic DNS
Keep a record pointed at a changing address: mark an A or AAAA record dynamic, send updates over the DynDNS2 protocol, IPv4 and IPv6, answers and router settings.
Nothing matches that search. Try a record type or a shorter word.