Private DNS: Quickstart

Last update: November 03 2026Open in Markdown

To configure DNS in a private network of the Cloud Platform, you create a private DNS zone with records. You can also:

• add a network to a private DNS zone — if a network is added to a DNS zone, adding or changing a port in this network automatically creates or updates an A or AAAA record for it. The fully qualified domain name (FQDN) of the port in the record is generated as <server_hostname>.<zone_domain_name>., where <server_hostname> is the server hostname, <zone_domain_name> is the zone domain. You can change the port domain name manually, and the record in the zone will update automatically;
• connect a network to a private DNS resolver — if a network is connected to a DNS resolver, servers in this network can resolve domain names of all private DNS zones within their pool and project.

If you need to configure DNS in a private network of dedicated servers, the connection is made via a global router; for more information, see the Configure DNS in a dedicated server private network instructions.

To configure private DNS in a Cloud Platform network:

1. In the control panel, in the top menu, click Products and select Cloud Servers.

2. Go to Private DNS.

3. On the DNS zones tab, click Create DNS zone.

4. Select the pool where the private network is located.

5. Enter the zone domain. The domain can contain numbers, Latin letters, and hyphens. The domain cannot be a top-level domain, such as example.

6. Optional: enter the TTL in seconds or leave the default value. TTL is the time during which the zone resource records in the NS server cache are considered up-to-date and do not require recaching. The zone TTL will apply to records that do not have their own TTL specified.

7. Optional: select the network to add to the zone. If you add a network to the zone, A or AAAA records will be automatically created and updated for ports in the network. You can add a network to the zone at any time.

8. Optional: if you selected a network to add to the zone in step 7, connect it to the DNS resolver by selecting the network. You can connect a network to the DNS resolver at any time, even if the network is not added to the zone.

9. Optional: add records to the zone by clicking Add record and filling in the fields depending on the required record type. You can add, edit, and delete records at any time after creating the zone.

   A or AAAA

   If a network is added to a zone, A and AAAA records are created and added automatically; you do not need to create and update them manually. To add a record manually:

   9.1. Select the record type — A or AAAA.

   9.2. Enter the domain name for which the record will be created. The domain of the zone where you are creating the record will be automatically appended to it.

   9.3. Enter the IP addresses that will be associated with the domain name: IPv4 addresses for an A record, IPv6 addresses for an AAAA record. You can specify up to 100 IP addresses. Enter addresses separated by commas or spaces, or each address on a new line.

   9.4. Enter the record TTL in seconds. To apply the zone TTL, enter -1 or click Use zone TTL.

   9.5. Click Add.

   9.6. To add another record, click Add record and repeat steps 9.1–9.5.

   CNAME

   9.1. Select the record type — CNAME.

   9.2. Enter the domain alias — the domain name that should redirect to the target domain. The domain of the zone where you are creating the record will be automatically appended to it.

   9.3. Enter the target domain name to which the alias should redirect. It can be any domain name in FQDN format, ending with a dot.

   9.4. Enter the record TTL in seconds. To apply the zone TTL, enter -1 or click Use zone TTL.

   9.5. Click Add.

   9.6. To add another record, click Add record and repeat steps 9.1–9.5.

   MX

   9.1. Select the record type — MX.

   9.2. Enter the domain name for which the record will be created. The domain of the zone where you are creating the record will be automatically appended to it.

   9.3. Enter the priority and mail server name separated by a space, for example 10 mail.example.com. Priority is a number from 0 to 65,535; the lower the number, the higher the priority. The mail server name must be in the zone domain.

   9.4. Optional: to add another mail server, click + and enter the priority and server name. You can add up to 100 mail servers.

   9.5. Enter the record TTL in seconds. To apply the zone TTL, enter -1 or click Use zone TTL.

   9.6. Click Add.

   9.7. To add another record, click Add record and repeat steps 9.1–9.6.

   TXT

   9.1. Select the record type — TXT.

   9.2. Enter the domain name for which the record will be created. The domain of the zone where you are creating the record will be automatically appended to it.

   9.3. Enter the record value — any text of up to 255 characters.

   9.4. Optional: to add another value, click + and enter the record value. You can add up to 100 values.

   9.5. Enter the record TTL in seconds. To apply the zone TTL, enter -1 or click Use zone TTL.

   9.6. Click Add.

   9.7. To add another record, click Add record and repeat steps 9.1–9.6.

10. Click Create DNS zone.

11. If you connected the network in the zone to the DNS resolver in step 8, specify the resolver IP addresses in the subnet settings of this network. Use the Change DNS servers in a private subnet section of the Private networks and subnets instructions.

    You can view the DNS resolver IP addresses in the network in the control panel: in the top menu, click Products → Cloud Servers → Private DNS → DNS resolvers tab → network row → DNS resolver field.

12. Optional: if you connected the network in the zone to the DNS resolver in step 8, enable public domain resolution by enabling the recursor on the DNS resolver.