Guides & documentation

Step-by-step guides for every PrimeDNS feature, from adding your first domain to split-horizon views, DNSSEC and team access.

  1. Quick Start

    Get PrimeDNS running in minutes: add a domain, create an API key, create your first DNS record, and verify it resolves.

    2 min read

  2. 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.

    2 min read

  3. SPF, DKIM & DMARC Setup

    Set up SPF, DKIM and DMARC using the built-in PrimeDNS wizards, and roll out DMARC enforcement safely.

    3 min read

  4. Bulk Reverse DNS (PTR)

    Create reverse DNS zones and bulk-generate PTR records via CSV import, CIDR sweep, or auto-generate from A/AAAA.

    2 min read

  5. Split-Horizon Views

    Answer DNS queries differently depending on client network — internal LAN vs. public internet — with PrimeDNS Split-Horizon Views.

    2 min read

  6. 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.

    2 min read

  7. Webhooks & Alerts

    Get notified in real time on DNS changes and resolver health via HMAC-signed webhooks and configurable alert rules.

    12 min read

  8. Audit Log

    Every DNS record change logged with who, when, from what IP, and the full before/after diff — filterable and exportable to CSV.

    1 min read

  9. Observability

    p95 latency, SERVFAIL/NXDOMAIN rates, top resolvers, geographic distribution and more — real-time DNS analytics built into PrimeDNS.

    2 min read

  10. Team & RBAC

    Invite teammates with role- and zone-scoped access — Admin, Billing, DNS Manager, DNS Viewer, Monitoring.

    2 min read

  11. 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.

    6 min read

  12. 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.

    1 min read

  13. 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.

    2 min read

  14. 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.

    6 min read

  15. 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.

    3 min read

  16. Webhook events

    Reference for PrimeDNS webhooks: delivery headers, signature verification, retries, the event envelope and the data of every event.

    6 min read

  17. 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.

    3 min read

  18. API changelog

    What changed in the PrimeDNS API and when: added, changed and deprecated fields and operations, by version.

    4 min read

  19. 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.

    9 min read

  20. 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.

    5 min read

  21. 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.

    4 min read