- Documentation
- Domains & Networking
- Guara DNS
Last updated: November 19, 2026
Guara DNS
Guara DNS answers for your whole domain (example.com.br) from Guara’s nameservers, ns1.guara-dns.com and ns2.guara-dns.com. You manage its records in the dashboard, next to your services:
- Custom domains without CNAMEs. A custom domain inside a domain hosted here gets its record automatically, root domains (
example.com.br) included. - Every record in one place: your site, email (MX, SPF, DKIM, DMARC), verification records and anything pointing outside Guara.
- A safe move in. Guara reads the records your current DNS provider serves, copies the ones you pick and shows what would change before you switch.
Adding a domain
You need to be an owner, admin or member of the project, and to control the domain at its registrar (where you bought it, such as Registro.br).
-
Add the domain
In the dashboard, open DNS in the sidebar and click Add domain. Pick the project and type the domain, for example
example.com.br. Use the registrable domain itself, not a subdomain: Guara hostsexample.com.br, andwwwbecomes one of its records. -
Copy the records you use today
Under Before you switch nameservers, Guara lists the records it found at your current DNS provider for the common names (the domain itself,
www, email, DKIM, DMARC and a few more). New ones come selected; click Copy to add them. Records under other names need to be added by hand or imported. -
Check what changes
What changes with the switch compares what your current DNS answers with what Guara will answer. Fix anything marked Fix before switching: those are usually email records, and a missing MX record means email stops arriving.
-
Switch the nameservers at your registrar
Replace the domain’s nameservers with only Guara’s. See Switching nameservers for Registro.br and other registrars.
-
Wait for the switch
Guara checks the registry every 5 minutes for the first 2 hours, then every 30 minutes. Click Check now to check at once. The domain turns Active as soon as the registry lists Guara’s nameservers.
The domain is reserved for your project for 14 days while you switch. If the registry still doesn’t list Guara’s nameservers by then, the claim expires and the domain is released. You get an email 3 days before.
Domain states
| State | Meaning |
|---|---|
| Waiting for nameservers | Added, but the registry doesn’t list Guara’s nameservers yet |
| Active | Guara answers for the domain |
| Nameservers incomplete | The registry lists only some of Guara’s nameservers. It works; add the missing ones |
| Mixed nameservers | The registry lists Guara’s and other nameservers. Answers depend on the server a resolver picks |
| Delegation lost | The registry no longer lists Guara: the domain is answered elsewhere |
| Offline | Guara stopped answering for the domain, usually because the account is suspended |
Custom domains in a Guara DNS domain
When you add a custom domain to a service and its domain is hosted on Guara DNS (in any project of the same account where you can manage DNS), Guara creates the record itself:
- No CNAME to configure, and the Domains tab shows the domain as Guara DNS.
- Root domains work, such as
example.com.br. Guara publishes the service’s addresses at the root and keeps them up to date. - The record is locked in the DNS editor; it goes away when you remove the custom domain.
Custom domains you added before moving the domain to Guara DNS keep working through their CNAME. When you copy records from your current DNS, Guara offers their CNAMEs too.
Limits
| Resource | Starter | Pro | Max | Business | Enterprise |
|---|---|---|---|---|---|
| Guara DNS domains (per account) | 10 | 25 | 50 | 100 | 250 |
| Records per Guara DNS domain | 500 | 500 | 500 | 500 | 500 |
Domains count per account, across all its projects, including domains still waiting for nameservers. The records Guara manages (SOA and the root NS records) don’t count.
Deleting a domain
Open the domain, scroll to Delete domain and type the domain name to confirm.
- Guara stops answering for it at once. If the registry still points at Guara, the domain stops resolving: switch the nameservers first (see Leaving Guara DNS).
- You can’t delete a domain while custom domains of your services use it. Remove those custom domains first; the error lists them.
- The domain stays reserved to your project while the registry still lists Guara, and for 30 days after it stops. Adding it again in the same project in that time brings it back as it was, records included.
Leaving Guara DNS
-
Export the records
On the domain’s page, click Export above the records to download a zone file (BIND format). Most DNS providers import it.
-
Set up the new provider
Import the file there and check the records. Custom domains of your Guara services need a CNAME at the new provider; their target is shown on each service’s Domains tab.
-
Switch the nameservers
At the registrar, replace Guara’s nameservers with the new provider’s. Resolvers can keep the old ones for up to 48 hours.
-
Delete the domain on Guara
After the switch, delete the domain here. Deleting it earlier makes it stop resolving.
If your account is suspended
While an account is suspended (for example, after failed payments), its domains stop answering, but they stay reserved: nobody else can take them. They come back by themselves when the account is reactivated.