bunny dns

Manage DNS zones and records from the command line.

bunny dns is experimental and hidden from --help and the landing page while it stabilizes. Commands and flags may change.

bunny dns manages DNS through three resource groups:

• bunny dns record manages the entries within a zone.
• bunny dns zone manages the zone itself: settings, DNSSEC, logging, stats, and nameservers.
• bunny dns script manages Scriptable DNS scripts.

The [domain] argument accepts either the zone’s domain name or its numeric zone ID, and is optional everywhere. Omit it and you’ll be prompted to pick a zone. record update and record remove likewise prompt you to pick a record when the ID is omitted.

record aliases to records / rec; zone aliases to zones (and domain / domains); script aliases to scripts.

Records

Manage the DNS records within a zone.

# List records within a zone
bunny dns record list example.com
bunny dns rec ls example.com

# Add records (use '@' for the zone apex)
bunny dns record add example.com api A 198.51.100.1
bunny dns record add example.com '@' MX mail.example.com 10
bunny dns record add example.com '@' SRV 10 0 389 sip.example.com
bunny dns record add example.com '@' CAA '0 issue "letsencrypt.org"'

# Link a record to a pull zone or Edge Script
bunny dns record add example.com cdn PullZone --pull-zone 12345
bunny dns record add example.com fn Script --script 67890

# Interactive wizard: omit the record type (or all args) to be prompted
bunny dns record add
bunny dns record add example.com

# Update / remove a record by its ID
bunny dns record update example.com 123 --value 198.51.100.2 --ttl 3600
bunny dns record remove example.com 123

# Import / export a BIND zone file
bunny dns record import example.com ./zonefile.txt
bunny dns record export example.com                  # print to stdout
bunny dns record export example.com --file ./my.zone # write to a path
bunny dns record export example.com --save           # write to ./example.com.zone

Record value ordering

Positional values for record add follow the record type:

Type	Positional values
A / AAAA / CNAME / TXT / NS	<value>
MX	<value> <priority>
SRV	<priority> <weight> <port> <target>
CAA	'<flags> <tag> "<value>"' (single quoted string)
PullZone	none, pass --pull-zone <id>
Script	none, pass --script <id>

Omit the record type (or all arguments) to run an interactive wizard that prompts for the zone, type, and per-type values.

Zones

Manage zone lifecycle, statistics, nameservers, DNSSEC, and query logging.

# Lifecycle
bunny dns zone list
bunny dns zone add example.com
bunny dns zone show example.com
bunny dns zone remove example.com

# Query statistics (defaults to the last 30 days; text mode draws a bar chart)
bunny dns zone stats example.com
bunny dns zone stats example.com --from 2026-05-01 --to 2026-05-31

# Nameservers to set at your registrar (custom if enabled, else bunny.net defaults)
bunny dns zone nameservers example.com
bunny dns zone ns example.com

# DNSSEC: enable prints the DS record to register at your domain registrar
bunny dns zone dnssec enable example.com
bunny dns zone dnssec disable example.com

# DNS query logging: enable to start collecting logs (optionally anonymize IPs)
bunny dns zone logging enable example.com
bunny dns zone logging enable example.com --anonymize-ip --anonymization drop
bunny dns zone logging disable example.com

Scripts

Manage Scriptable DNS scripts: code that computes a DNS answer at query time, such as geo routing, weighted or failover answers, and closest-region selection. These are separate from Edge Scripts (bunny scripts, a different runtime).

A script only affects DNS once it backs a SCRIPT record on a zone. Use attach to add that record from the script side.

# Scaffold a project: entry file, tsconfig, and package.json with a devDep on
# @bunny.net/scriptable-dns-types for editor autocomplete
bunny dns scripts init                                 # interactive wizard
bunny dns scripts init geo-router --example geo --deploy

# Create a remote script without scaffolding
bunny dns scripts create geo-router

# Upload and publish
bunny dns scripts deploy                               # linked script's entry file
bunny dns scripts deploy handleQuery.js
bunny dns scripts deploy handleQuery.js 12345          # target a specific script
bunny dns scripts deploy --skip-publish                # stage without publishing

# Link the current directory to a script / list all scripts
bunny dns scripts link 12345
bunny dns scripts list

# Point a hostname at a script by adding a SCRIPT record
bunny dns scripts attach example.com api --script 12345
bunny dns scripts attach example.com '@'               # apex, using the linked script

Scripts resolve without an explicit ID in this order: explicit [id], then .bunny/dns-script.json (written by link / create / init), then the interactive picker.

init starters via --example: empty, geo, closest, weighted, failover, pullzone. Pass --deploy to also create the script on bunny.net after scaffolding.

attach always confirms before writing the record, and attaching at the apex ('@') prints a stronger warning listing any records already at that name.

Flags

Flag	Commands	Description
--ttl	record add, record update	Time to live in seconds
--comment	record add, record update	Optional comment for the record
--pull-zone, --script	record add, record update	Link a PullZone / Script record by ID
--name, --value, --type, --priority, --weight, --port, --flags, --tag, --disabled	record update	Edit individual record fields (see bunny dns record update --help)
--file, --save	record export	Write to a path, or to <domain>.zone in the current directory
--from, --to	zone stats	Date range (defaults to the last 30 days)
--anonymize-ip, --anonymization	zone logging enable	Anonymize client IPs in logs (onedigit | drop)
--example, --deploy, --skip-install	scripts init	Starter template, create on bunny.net, skip type dependency install
--skip-publish	scripts deploy	Stage the upload without publishing
--script, --ttl	scripts attach	DNS script ID (defaults to the linked script), record TTL
--force	record remove, zone remove, zone dnssec disable, zone logging disable, scripts attach	Skip the confirmation prompt