Nameserver Group Form
Create or edit a nameserver group: a name, an optional description, an ordered list of up to eight DNS servers, and the per-query timeout.
Inputs
| Name | Description | Allowed values | Default |
|---|---|---|---|
Name | Unique label for this group | Non-empty string, must be unique across nameserver groups | — |
Description | Optional free-text note | Any text | Empty |
Nameserver host | IP address or hostname of a DNS server | Up to 253 characters | — |
Nameserver port | UDP/TCP port the server listens on | 1–65535 | 53 |
Query timeout (ms) | Wait per server before moving to the next entry | 100–10,000 | 2000 |
How to
Add a second server as a fallback
- Click "Add nameserver" below the list.
- Enter the host and port; leave the port at 53 for a standard DNS server.
- Order matters — use the arrows to move the preferred server first.
- Save. Templates already pointing at this group use the new list from their next execution.
Gotchas
- At least one nameserver is required and at most eight are allowed.
- Hostnames are resolved by the RESOLVER host when it dials; prefer IP addresses for servers the resolver itself needs DNS to find.
API calls (2)
| Method | Path | Description |
|---|---|---|
| POST | /api/config/nameserver-groups | Create a nameserver group |
| PUT | /api/config/nameserver-groups/:id | Update a nameserver group |
Related
- Nameserver Groups — The list this form creates entries for