Change Default NS

A Name Server (NS) Record is a type of DNS record that indicates which DNS server is authoritative for a specific domain. It directs DNS queries to the correct server, where other records like A, MX, or CNAME are stored. For example, an NS record for example.com might point to ns1.vergecloud.com and ns2.vergecloud.com, which handle all DNS requests for example.com.

VergeCloud provides new NS (Name Server) addresses for domains using DNS and CDN services. If you encounter issues with the compatibility of specific NS addresses, you may want to switch to alternative NSs with different TLDs for better compatibility or to meet specific domain registrar requirements. In such cases, you can change the default NSs to those with "net" and "com" TLDs by following these steps.

Using Custom NS

VergeCloud DNS allows you to use custom nameservers for your domain. With this feature, you can activate VergeCloud CDN and DNS services using dedicated nameservers, giving you more control and branding options.

Note: This feature is available in the professional and enterprise plans. Please upgrade your plan if you wish to use custom NSs. Custom NSs Changes account level, applying these nameservers to all your domains and new domains NSs will be new NSs.

Setting Custom NS via Dashboard

To set custom NSs, navigate to your VergeCloud CDN panel, and then go to the "DNS records" section. 

In the "Customize Domain NS" section, enter your desired nameservers and confirm the changes.

Setting Custom NS via API

You can also use the VergeCloud API to set custom NSs. Below is an example request:

curl --location --request PUT 'https://api.vergecloud.com/domains/example.com/ns-keys' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{"ns_keys":["ns1.example.com","ns2.example.com"]}'

Adding Glue Records

A Glue Record is a DNS record that provides the IP address of a nameserver when that nameserver is part of the domain it serves. Glue records prevent circular dependencies when resolving a domain. For example, if ns1.example.com is the authoritative nameserver for example.com, a glue record supplies the IP address of ns1.example.com to facilitate DNS resolution.

After setting custom NSs, VergeCloud will assign IPs to these nameservers. You will need to copy these IPs and register them as Glue Records in your domain registrar.

Testing

To verify the custom NS setup, use the following dig command:

dig NS example.com

Sample Test Output

; <<>> DiG 9.16.1-Ubuntu <<>> NS example.com
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 56473
;; flags: qr rd ra; QUERY: 1, ANSWER: 2, AUTHORITY: 1, ADDITIONAL: 1

;; QUESTION SECTION:
;example.com.                   IN      NS

;; ANSWER SECTION:
example.com.            86400   IN      NS      ns1.example.com.
example.com.            86400   IN      NS      ns2.example.com.

;; Query time: 58 msec
;; SERVER: 8.8.8.8#53(8.8.8.8)
;; WHEN: Thu
;; MSG SIZE  rcvd: 114

Considerations

• Custom NSs must be registered with their corresponding Glue Records, or they may not resolve correctly.
• Propagation of custom NS changes may take up to 48 hours.