bunny dns - bunny.net Documentation

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

​Records

​Record value ordering

​Zones

​Scripts

​Flags

Records

Record value ordering

Zones

Scripts

Flags