Skip to main content

​
Overview

A DNS zone is the authoritative domain boundary that contains all record sets for a given domain (e.g., example.com.). Creating a zone in Polystack DNS registers that domain with the platform’s nameservers and makes it available for record management. Zones are project-scoped — each zone belongs to the project that created it. Users in other projects cannot see or modify your zones unless access is explicitly shared.
Prerequisites
  • An active Polystack account with appropriate permissions
  • Access to the Polystack Dashboard or CLI configured with credentials
  • API credentials sourced (source openrc.sh)

​
Zone Types

​
Create a Zone

1

Navigate to DNS Zones

Navigate to Network > DNS Zones.Click Create Zone to open the creation dialog.
2

Enter the zone name

Enter the Name for your zone. This is the fully qualified domain name (FQDN).
The zone name must end with a trailing dot (e.g., example.com.). The API requires more than one label — use example.com. rather than example. for a valid zone.
3

Add a description (optional)

Enter an optional Description to identify this zone in listings (e.g., “Production application zone”).
4

Select the zone type

Choose the Type from the dropdown:The form fields change dynamically based on your selection.
Primary is the default and most common type. Select Secondary only when replicating an existing zone from an external DNS server.
5

Configure Primary zone fields

For Primary zones, these additional fields appear:Email Address (required) — The administrative contact email for this zone. Written into the SOA record. Must be a valid email address.TTL (Time To Live) (required) — Default TTL in seconds for records in this zone. Default value: 3600 (1 hour). Minimum: 0.
Use 3600 for most production zones. Use a lower TTL (e.g., 300) before planned DNS changes to reduce propagation delay, then increase it after the change is confirmed stable.
6

Configure Secondary zone fields

For Secondary zones, the Email and TTL fields are hidden and a different field appears:Masters (required) — The IP addresses of the primary DNS servers to slave from. Click the add button to add one or more IP addresses.
The master servers must allow zone transfers (AXFR) to the Polystack DNS nameservers. Configure the allow-transfer ACL on your primary DNS server before creating the secondary zone.
7

Create the zone

Click Confirm. The zone enters Pending status during creation and transitions to Active within a few seconds.
Zone appears in the DNS Zones list with status Active.

​
Zone Lifecycle

​
Edit a Zone

1

Open the edit dialog

Navigate to Network > DNS Zones. Click the Edit action on the zone row.
2

Update editable fields

The zone Name and Type cannot be changed after creation. You can update:
3

Save changes

Click Confirm. The zone enters Pending briefly during the update.

​
Delete a Zone

1

Select zones to delete

Navigate to Network > DNS Zones. Select one or more zones using the checkboxes and click Delete in the batch actions bar.Alternatively, click the More menu on a zone row and select Delete. The More menu also includes Create Record Set — see Manage Records for details.
2

Confirm deletion

Confirm the deletion in the dialog.
Deleting a zone removes all record sets within it permanently. DNS resolution for the domain will fail immediately. Ensure the zone is no longer in use before deletion.

​
View Zone Details

Click a zone name in the list to open the detail page. The Overview tab shows:The Record Sets tab shows all records in the zone — see Manage Records.

​
Next Steps

Manage Records

Add A, AAAA, CNAME, MX, and TXT records to your zone

Record Types Reference

Full reference for every supported DNS record type

Reverse DNS

Configure PTR records for your zone’s IP addresses

Troubleshooting

Resolve zone stuck in Pending or Error status