The DNS page allows you to manage DNS zones and records using the integrated PowerDNS server or external DNS providers.
DNS Overview
The main DNS view shows all configured zones:
- Zone Name — Domain name (e.g., example.com)
- Type — Master or Slave zone
- Records — Number of DNS records
- Serial — Zone serial number
- Status — Active or disabled
PowerDNS Status
The DNS page header shows the PowerDNS service status:
- Running — Service is active
- Stopped — Service is not running
- Not Configured — PowerDNS not set up
Enabling PowerDNS
If PowerDNS is not enabled:
- Click "Enable PowerDNS"
- Wait for the service to deploy
- Service becomes available on port 53
Creating a Zone
- Click "Create Zone"
- Enter zone details:
- Zone Name — Domain name (e.g., example.com)
- Type — Master (primary) or Slave (secondary)
- Nameservers — NS records for the zone
- Click "Create"
Note: Zone names should not include a trailing dot in the UI. It's added automatically.
Managing Records
Click on a zone to view and manage its DNS records.
Adding Records
- Open the zone
- Click "Add Record"
- Configure the record:
- Name — Subdomain or @ for root
- Type — Record type (A, AAAA, CNAME, etc.)
- Content — Record value
- TTL — Time to live in seconds
- Click "Add"
Record Types
| Type | Use Case | Example Content |
|---|---|---|
| A | IPv4 address | 192.168.1.100 |
| AAAA | IPv6 address | 2001:db8::1 |
| CNAME | Alias to another name | www.example.com |
| MX | Mail server | 10 mail.example.com |
| TXT | Text data (SPF, DKIM) | v=spf1 include:_spf.google.com ~all |
| NS | Name server | ns1.example.com |
| SRV | Service location | 10 5 443 server.example.com |
| CAA | Certificate authority | 0 issue "letsencrypt.org" |
Editing Records
- Find the record in the zone
- Click the edit icon
- Modify the content or TTL
- Save changes
Deleting Records
- Select the record
- Click the delete icon
- Confirm deletion
Quick Record Creation
Common record templates for quick setup:
Web Server
Automatically creates:
- A record for root domain
- A record for www subdomain
Mail Server
Automatically creates:
- MX record
- SPF TXT record
- A record for mail subdomain
Zone Settings
Configure zone-level settings:
- SOA Settings — Serial, refresh, retry, expire, TTL
- DNSSEC — Enable/disable DNSSEC
- Zone Transfer — Configure AXFR settings
Deleting a Zone
- Go to the zones list
- Select the zone
- Click "Delete Zone"
- Confirm deletion
Warning: Deleting a zone removes all its records. This action cannot be undone.
External DNS Providers
If using external DNS (Cloudflare, Route53, etc.), the UI shows provider-specific options:
- Provider status and connection
- Zone synchronization
- Provider-specific features (e.g., Cloudflare proxy)
Switching Providers
- Go to Settings → DNS
- Select the new provider
- Enter credentials
- Save and test connection
DNS for Deployments
Automatically create DNS records for deployments:
- Navigate to the deployment
- Go to Settings → Domain
- Enter the domain name
- Enable "Auto-create DNS record"
- Record is created automatically
Propagation Check
Verify DNS changes have propagated:
- Click on a record
- Click "Check Propagation"
- View status from multiple DNS servers
Zone Export
Export a zone in BIND format:
- Open the zone
- Click "Export"
- Download the zone file
Zone Import
Import records from a BIND zone file:
- Click "Import Zone"
- Paste or upload the zone file
- Review the records
- Confirm import
Best Practices
- Appropriate TTLs — Lower for frequently changing records (300-900), higher for stable records (3600+)
- Backup zones — Export zones before major changes
- Test changes — Verify DNS resolution after updates
- SPF/DKIM/DMARC — Configure email authentication records
- CAA records — Limit certificate issuance to authorized CAs
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
n | Create new zone/record |
r | Refresh zones |
/ | Focus search |