How to Add DNS Records Using a Zone File on VergeCloud

Adding DNS Records with a Zone File on VergeCloud: A Complete Guide

How to Upload the DNS Zone File to VergeCloud User Panel

In DNS architecture, a Zone represents the administrative control of a domain and its sub-domains. When a new domain is created, a corresponding Zone is established, which stores the domain records in a text-based format.

When migrating to a new DNS server, it is essential to transfer all existing DNS records from the old server to the new one. While it is possible to manually add these records, a more reliable and efficient solution is to upload the DNS Zone File, which will import the records automatically.

With VergeCloud's Cloud DNS, you have the capability to migrate all of your domain's DNS records seamlessly by uploading the DNS Zone File through the VergeCloud user panel.

First, you need to obtain your DNS Zone File. Most DNS providers provide options to download this file, and if you're using BIND, the configuration can typically be found in a file named named.conf.

Important Points for DNS Zone Files

  • The uploaded DNS Zone File must adhere to the BIND standard format.
  • TTL values will be imported as specified in the Zone File. If a TTL value is not defined, it will default to 120 seconds.
  • The directive $ORIGIN in the Zone File will be disregarded.
  • Directives such as $INCLUDE and $GENERATE will not be processed.
  • The supported DNS record types for uploads include A, AAAA, CAA, CNAME, MX, NS, SOA, SRV, PTR, and TXT records.
  • The SOA record from the uploaded Zone File will be replaced with a new one provided by VergeCloud.
  • The NS records from the uploaded file will also be replaced with VergeCloud's default NS records.

Step-by-Step Guide: Uploading a DNS Zone File to VergeCloud User Panel

  1. Navigate to the DNS Records section under CDN settings in the VergeClud user panel.

  2. Click on the DNS Import button. A file selection window will appear, allowing you to locate the DNS Zone File saved on your computer.
  3. Select the file, then click the Open button. The DNS Zone File will be uploaded, and the records will be added to VergeCloud's user panel.

Uploading DNS Zone File via API

  1. VergeCloud also allows you to upload a DNS Zone File via API. Below is an example API request that shows how to import the Zone File:
  2. curl --request POST \
--url 'https://api.vergecloud.com/domains/example.com/dns-records/import' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: multipart/form-data' \
--form f_zone_file=@/path/to/txt/file.txt