Skip to content

DNS Records¶

Manage DNS records within a zone.

List Records¶

bnerd dns records list <zone-id>

Lists all DNS records in the specified zone.

Create a Record¶

bnerd dns records create <zone-id> [flags]

Flags¶

Flag	Type	Default	Required	Description
`--name`	string		Yes	Record name (FQDN with trailing dot)
`--type`	string		Yes	Record type (A, AAAA, CNAME, TXT, MX, SRV, etc.)
`--content`	string[]		Yes	Record content (repeatable for multi-value records)
`--ttl`	int	`300`	No	TTL in seconds
`--disabled`	bool	`false`	No	Create the record in disabled state

Examples¶

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

# Multiple A records (round-robin)
bnerd dns records create <zone-id> \
  --name www.example.com. \
  --type A \
  --content 1.2.3.4 \
  --content 5.6.7.8

# CNAME record
bnerd dns records create <zone-id> \
  --name blog.example.com. \
  --type CNAME \
  --content example.com.

# TXT record
bnerd dns records create <zone-id> \
  --name _verify.example.com. \
  --type TXT \
  --content "verification-token-here"

# MX record
bnerd dns records create <zone-id> \
  --name example.com. \
  --type MX \
  --content "10 mail.example.com." \
  --ttl 3600

Update a Record¶

bnerd dns records update <zone-id> <record-name> <record-type> [flags]

Flags¶

Flag	Type	Default	Required	Description
`--content`	string[]		Yes	New record content (replaces all existing values)
`--ttl`	int	`300`	No	New TTL in seconds
`--disabled`	bool	`false`	No	Toggle disabled state

Example¶

bnerd dns records update <zone-id> www.example.com. A \
  --content 9.10.11.12 \
  --ttl 600

Replace semantics

Update replaces all existing content values for the record. To add content, include both old and new values in the --content flags.

Delete a Record¶

bnerd dns records delete <zone-id> <record-name> <record-type>

Example¶

bnerd dns records delete <zone-id> www.example.com. A

Supported Record Types¶

Type	Description	Content format
`A`	IPv4 address	`1.2.3.4`
`AAAA`	IPv6 address	`2001:db8::1`
`CNAME`	Canonical name	`target.example.com.`
`TXT`	Text record	`"any text value"`
`MX`	Mail exchange	`10 mail.example.com.` (priority + host)
`SRV`	Service locator	`10 5 443 target.example.com.`
`NS`	Name server	`ns1.example.com.`
`CAA`	Cert authority auth	`0 issue "letsencrypt.org"`

TUI Equivalent¶

In the interactive TUI (bnerd x), navigate to a zone and press d for detail view to see records. Use a to add a new record.