Skip to content

DNS Management

The bnerd dns command group manages DNS zones and records.

Overview

DNS management is a two-level hierarchy:

  1. Zones — DNS zones (e.g., example.com.) that contain records
  2. Records — Individual DNS records within a zone (A, AAAA, CNAME, MX, TXT, etc.)

You must create a zone before you can add records to it.

Commands

Requirements

DNS commands require --token and --org-id (organization-scoped).

Quick Example

# Create a zone
bnerd dns zones create example.com

# Add an A record
bnerd dns records create <zone-id> \
  --name www.example.com. \
  --type A \
  --content 1.2.3.4

# List all records
bnerd dns records list <zone-id>

Trailing dot

DNS names should use FQDN format with a trailing dot (e.g., example.com., www.example.com.).