Documentation Index
Fetch the complete documentation index at: https://docs.xloud.tech/llms.txt
Use this file to discover all available pages before exploring further.
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 Xloud 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 Xloud account with appropriate permissions
- Access to the Xloud Dashboard or CLI configured with credentials
- API credentials sourced (
source openrc.sh)
Zone Types
| Type | Description | Use Case |
|---|---|---|
| Primary | Your authoritative copy — you manage all records directly | Standard zone management |
| Secondary | Read-only replica slaved from another DNS server via zone transfer | Disaster recovery, geographic redundancy |
Create a Zone
- Dashboard
- CLI
Navigate to DNS Zones
Navigate to
Network > DNS Zones.Click Create Zone to open the creation dialog.
Add a description (optional)
Enter an optional Description to identify this zone in listings
(e.g., “Production application zone”).
Select the zone type
Choose the Type from the dropdown:
The form fields change dynamically based on your selection.
| Type | Description |
|---|---|
| Primary | Controlled by Xloud DNS — you manage the records directly |
| Secondary | Slaved from another DNS server — records are pulled via zone transfer |
Primary is the default and most common type. Select Secondary only when
replicating an existing zone from an external DNS server.
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.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.
| Rule | Detail |
|---|---|
| Minimum | At least 1 master IP is required |
| Format | Valid IPv4 or IPv6 address |
| Duplicates | Not allowed — each IP must be unique |
The master servers must allow zone transfers (AXFR) to the Xloud DNS
nameservers. Configure the allow-transfer ACL on your primary DNS server
before creating the secondary zone.
Zone Lifecycle
Edit a Zone
- Dashboard
- CLI
Update editable fields
The zone Name and Type cannot be changed after creation. You can
update:
| Zone Type | Editable Fields |
|---|---|
| Primary | Description, Email Address, TTL |
| Secondary | Description, Masters |
Delete a Zone
- Dashboard
- CLI
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.
View Zone Details
- Dashboard
- CLI
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.
| Section | Fields |
|---|---|
| Summary | Name, Description, Type (Primary/Secondary), Status (Active/Pending/Error), Email |
| Base Info | Action, Serial, TTL, Version |
| Modification Times | Created At, Updated At, Transferred |
| Attributes | Zone attributes (JSON) |
| Associations | Pool ID, Project ID, Masters (for secondary zones) |
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