- Documentation
- Domains & Networking
- Switching Nameservers
Last updated: November 19, 2026
Switching Nameservers
A domain’s nameservers are set at its registrar, where the domain was bought (Registro.br for .br domains, or GoDaddy, Namecheap, Hostinger and others). To host the domain on Guara DNS, replace them with Guara’s:
ns1.guara-dns.com
ns2.guara-dns.com
The domain’s page in the dashboard shows the same list, with copy buttons, next to what the registry lists for the domain right now.
Before you start
- Turn off DNSSEC at the registrar if it’s on (remove the DS records). Guara DNS doesn’t sign zones yet, and a leftover DS record makes the domain fail to resolve.
- Use only Guara’s nameservers. Mixing Guara’s with your old provider’s makes answers depend on which server a resolver asks.
- Domains registered at Cloudflare Registrar must use Cloudflare’s nameservers. Transfer the domain to another registrar first.
Registro.br
- Sign in at registro.br with the account that holds the domain.
- Open the domain from your domain list.
- In the DNS section, choose to change the DNS servers.
- Enter
ns1.guara-dns.comandns2.guara-dns.com, with no other servers. - Save. Registro.br checks that the new servers answer for the domain before accepting them; Guara already does, from the moment you add the domain.
The change usually shows in the registry within a few hours.
Other registrars
- Sign in at the registrar and open the domain.
- Find the nameserver setting. It’s often called Nameservers, DNS servers or Custom DNS, sometimes under DNS or Manage.
- Choose to use your own (custom) nameservers instead of the registrar’s.
- Enter
ns1.guara-dns.comandns2.guara-dns.com, and remove any others. - Save.
Checking the switch
Guara checks the registry every 5 minutes for the first 2 hours, then every 30 minutes, and activates the domain as soon as it lists Guara’s nameservers. Check now on the domain’s page checks at once.
From a terminal, dig shows what the registry lists:
dig example.com.br NS +trace | tail -n 5
Problems
| What you see | What to do |
|---|---|
| The domain is already in use by another project | Another project holds it. If it’s yours, add it from that project. If not, contact support with proof that you own the domain. |
| The domain already points at Guara’s nameservers | The registry lists Guara but no project holds the domain. To protect it from takeover, point it at other nameservers at the registrar first (its own DNS works), add it here, then switch back. |
| Use the registrable domain | Add example.com.br, not app.example.com.br; the subdomain becomes a record. |
| The domain isn’t registered | The registry has no such domain. Check the spelling, or register it first. |
| Your plan’s domain limit is reached | Delete a domain you no longer use, or upgrade your plan. See the limits in Guara DNS. |
| Mixed nameservers on the domain | Remove the non-Guara nameservers at the registrar. |
| Nameservers incomplete | Add the missing Guara nameserver at the registrar. Some registrar forms show only two fields; that’s enough. |
| The domain is about to expire unclaimed | A domain waits 14 days for the switch. If time runs out, it’s released; add it again and switch sooner. |
Previous DNS Records
Next Service-to-Service Networking