---
title: "dns allocate"
slug: "dns-allocate"
tags: ["5.4"]
updated: 2026-10-28T01:53:23Z
published: 2026-10-28T01:53:23Z
canonical: "docs.vastdata.com/dns-allocate"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# dns allocate

# dns allocate

This command allocates and configures a VAST DNS server configuration.

## Usage

```plaintext
dns allocate --name NAME
            [--domain-suffix DOMAIN_SUFFIX]
            [--enable | --disable]
            [--net-type NORTH_PORT|SOUTH_PORT|EXTERNAL_PORT]
            [--cnode-ids CNODE_IDs]
            [--ttl TTL]
            [--port PORT]
```

## Required Parameters

| `--name NAME` | Specifies a name for the VAST DNS server configuration. |
| --- | --- |

## Options

| `--domain-suffix DOMAIN_SUFFIX` | Specifies a suffix to append to domain names of each VIP pool. The suffix should complete each domain name to form a valid FQDN for DNS requests to target. |
| --- | --- |
| `--enable` | Enables the VAST DNS service. |
| `--disable` | Disables the VAST DNS service. |
| `--net-type NORTH_PORT\|SOUTH_PORT\|EXTERNAL_PORT` | Specifies the network type interface for the DNS service. |
| `--cnode-ids CNODE_IDs` | Comma-separated IDs of CNodes (uses all CNodes if not specified). |
| `--ttl TTL` | Specifies the DNS TTL value. |
| `--port PORT` | Specifies a port for the DNS service. |

## Example

This example shows how to allocate a VAST DNS server configuration named VAST-DNS-Service:

```plaintext
vcli: admin> dns allocate --name VAST-DNS-Service --domain-suffix mycorp.cluster.com --port 53
```