Skip to content

UniFi Network Namecheap BasicDNS

Migrate DNS from UniFi to Namecheap.

5 record types move as they are. 4 things work differently at Namecheap, and the preview shows exactly which of your records they affect.

Free preview. Read-only. Nothing changes until you apply.

What works differently

Generated from the same provider capability data the migration engine uses.

Moves as-is

  • A
  • AAAA
  • CNAME
  • MX
  • TXT

TTLs below 60s are raised

Namecheap's minimum TTL is 60 seconds. Shorter TTLs are raised to 60s and shown as translated.

Namecheap rewrites the whole host list

Every write to Namecheap's API replaces all records. We read, merge and write once, so records outside the migration survive.

Namecheap needs BasicDNS turned on

Namecheap only accepts records while the domain uses its BasicDNS nameservers, so records are written at cutover time rather than staged in advance.

A typical UniFi zone at Namecheap

Example records for example.com. Open any flagged row to read why it changed.

UniFi Namecheap

  • ExactA@

    192.0.2.70

  • ExactAAAA@

    2001:db8::70

  • ExactMX@

    10 mx1.mail.example.net. +1

  • ExactTXT@

    "v=spf1 include:_spf.example.net -all"

  • ExactCAA@

    0 issue "letsencrypt.org"

  • ExactTXT_dmarc

    "v=DMARC1; p=reject; rua=mailto:dmarc@example.com"

  • UnsupportedSRV_sip._tls

    Not migrated

    Namecheap doesn't support SRV records through its API.

  • ExactCNAMEwww

    example.com.

How the move works

  1. 1

    Connect UniFi

    Connect UniFi with read-only access (API key (X-API-Key) + controller URL or UniFi console ID (via api.ui.com)).

  2. 2

    Connect Namecheap

    Connect Namecheap (API user + API key, with our egress IP allow-listed). Write access is only used when you apply.

  3. 3

    Review the preview

    Check every record marked Review or Unsupported. Each one explains what changes and why.

  4. 4

    Apply to Namecheap

    We snapshot the Namecheap zone, write in batches, and leave UniFi untouched.

  5. 5

    Verify

    We query Namecheap's own nameservers for every record and compare the answers before you switch.

  6. 6

    Switch nameservers

    Lower TTLs a day or two ahead, remove any DS record if DNSSEC is on, then point the domain at the new nameservers at your registrar.

Good to know about UniFi

  • Consoles usually sit on a private network; we refuse private addresses by design, so either use the console ID (reached through api.ui.com) or expose the console publicly over HTTPS.
  • A publicly trusted TLS certificate is required when connecting directly: we never skip certificate verification, so the console's default self-signed certificate will not work.
  • Records are one flat list per site (no zones); only A, AAAA and CNAME have a configurable TTL, and TXT values are limited to 255 characters without double quotes.

Access we need: A UniFi API key acts with the role of the admin who created it; create it from an admin limited to network settings where possible. It can read and write static DNS entries.

Good to know about Namecheap

  • Namecheap's API replaces the whole host list on every write, so we always read, merge and then write.
  • SRV records can't be managed through the API.
  • URL redirect records are Namecheap-specific and aren't real DNS records.

Access we need: API access enabled under Profile → Tools, with our static IP added to the allow-list.

Questions

Will there be downtime moving from UniFi to Namecheap?

Not if both providers serve the same answers during the switch. The records are copied to Namecheap and verified before you change nameservers, so resolvers get the same answer from either side while caches expire.

Do I have to delete anything at UniFi?

No. We never write to UniFi. Keep the old zone for a week after cutover so you can switch back instantly if anything looks wrong.

What about DNSSEC?

If DNSSEC is on, remove the DS record at your registrar and wait for it to expire before switching nameservers. Then enable DNSSEC at Namecheap and publish its new DS record. The cutover plan walks you through each step.

Ready to see your own zone?

Start a free preview