UI Guide

DNS Zones

Manage DNS zones and records through the FlatRun UI.

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:

  1. Click "Enable PowerDNS"
  2. Wait for the service to deploy
  3. Service becomes available on port 53

Creating a Zone

  1. Click "Create Zone"
  2. Enter zone details:
    • Zone Name — Domain name (e.g., example.com)
    • Type — Master (primary) or Slave (secondary)
    • Nameservers — NS records for the zone
  3. 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

  1. Open the zone
  2. Click "Add Record"
  3. Configure the record:
    • Name — Subdomain or @ for root
    • Type — Record type (A, AAAA, CNAME, etc.)
    • Content — Record value
    • TTL — Time to live in seconds
  4. 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

  1. Find the record in the zone
  2. Click the edit icon
  3. Modify the content or TTL
  4. Save changes

Deleting Records

  1. Select the record
  2. Click the delete icon
  3. 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

  1. Go to the zones list
  2. Select the zone
  3. Click "Delete Zone"
  4. 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

  1. Go to Settings → DNS
  2. Select the new provider
  3. Enter credentials
  4. Save and test connection

DNS for Deployments

Automatically create DNS records for deployments:

  1. Navigate to the deployment
  2. Go to Settings → Domain
  3. Enter the domain name
  4. Enable "Auto-create DNS record"
  5. Record is created automatically

Propagation Check

Verify DNS changes have propagated:

  1. Click on a record
  2. Click "Check Propagation"
  3. View status from multiple DNS servers

Zone Export

Export a zone in BIND format:

  1. Open the zone
  2. Click "Export"
  3. Download the zone file

Zone Import

Import records from a BIND zone file:

  1. Click "Import Zone"
  2. Paste or upload the zone file
  3. Review the records
  4. 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