From 1ce41abe4c8a0bfd28ebe5261d9e12fafe54d652 Mon Sep 17 00:00:00 2001 From: "J. Felix Etcetera" Date: Sun, 7 Jun 2026 18:23:02 +0200 Subject: [PATCH 1/3] Update docs to explain CNAME/ALIAS behavior. --- documentation/provider/bunnydns.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/documentation/provider/bunnydns.md b/documentation/provider/bunnydns.md index c6d09916af..d90c955060 100644 --- a/documentation/provider/bunnydns.md +++ b/documentation/provider/bunnydns.md @@ -37,6 +37,19 @@ export BUNNY_DNS_API_KEY=XXXXXXXXX This provider does not recognize any special metadata fields unique to Bunny DNS. +## Limitations + +### Records + +#### CNAME / ALIAS + +Bunny supports adding CNAME records for the root domain (`@`), but within +DNSControl the `ALIAS` record should be used. + +```javascript +D('example.com', REG_NONE, DnsProvider(DSP_BUNNY_DNS), ALIAS('@', 'example2.com')); +``` + ## Usage An example configuration: From fa7e67846a0a71104583c98decfe6d14cb1e9244 Mon Sep 17 00:00:00 2001 From: "J. Felix Etcetera" Date: Mon, 8 Jun 2026 15:31:00 +0200 Subject: [PATCH 2/3] Format file with Prettier. --- documentation/provider/bunnydns.md | 65 +++++++++++++++++++----------- 1 file changed, 41 insertions(+), 24 deletions(-) diff --git a/documentation/provider/bunnydns.md b/documentation/provider/bunnydns.md index d90c955060..d21eb64190 100644 --- a/documentation/provider/bunnydns.md +++ b/documentation/provider/bunnydns.md @@ -1,19 +1,22 @@ # Configuration -To use this provider, add an entry to `creds.json` with `TYPE` set to `BUNNY_DNS` along with -your [Bunny API Key](https://dash.bunny.net/account/settings). +To use this provider, add an entry to `creds.json` with `TYPE` set to +`BUNNY_DNS` along with your +[Bunny API Key](https://dash.bunny.net/account/settings). Example: {% code title="creds.json" %} + ```json { - "bunny_dns": { - "TYPE": "BUNNY_DNS", - "api_key": "your-bunny-api-key" - } + "bunny_dns": { + "TYPE": "BUNNY_DNS", + "api_key": "your-bunny-api-key" + } } ``` + {% endcode %} You can also use environment variables: @@ -23,19 +26,22 @@ export BUNNY_DNS_API_KEY=XXXXXXXXX ``` {% code title="creds.json" %} + ```json { - "bunny_dns": { - "TYPE": "BUNNY_DNS", - "api_key": "$BUNNY_DNS_API_KEY" - } + "bunny_dns": { + "TYPE": "BUNNY_DNS", + "api_key": "$BUNNY_DNS_API_KEY" + } } ``` + {% endcode %} ## Metadata -This provider does not recognize any special metadata fields unique to Bunny DNS. +This provider does not recognize any special metadata fields unique to Bunny +DNS. ## Limitations @@ -55,51 +61,62 @@ D('example.com', REG_NONE, DnsProvider(DSP_BUNNY_DNS), ALIAS('@', 'example2.com' An example configuration: {% code title="dnsconfig.js" %} + ```javascript -var REG_NONE = NewRegistrar("none"); -var DSP_BUNNY_DNS = NewDnsProvider("bunny_dns"); +var REG_NONE = NewRegistrar('none'); +var DSP_BUNNY_DNS = NewDnsProvider('bunny_dns'); -D("example.com", REG_NONE, DnsProvider(DSP_BUNNY_DNS), - A("test", "1.2.3.4"), -); +D('example.com', REG_NONE, DnsProvider(DSP_BUNNY_DNS), A('test', '1.2.3.4')); ``` + {% endcode %} # Activation -DNSControl depends on the [Bunny API](https://docs.bunny.net/reference/bunnynet-api-overview) to manage your DNS -records. You will need to generate an [API key](https://dash.bunny.net/account/settings) to use this provider. +DNSControl depends on the +[Bunny API](https://docs.bunny.net/reference/bunnynet-api-overview) to manage +your DNS records. You will need to generate an +[API key](https://dash.bunny.net/account/settings) to use this provider. ## New domains -If a domain does not exist in your Bunny account, DNSControl will automatically add it with the `push` command. +If a domain does not exist in your Bunny account, DNSControl will automatically +add it with the `push` command. ## Custom record types -DNSControl supports only the custom record types listed below for Bunny DNS. Other Bunny-specific types -(such as Script or Flatten) are not supported and will be ignored by DNSControl and left as-is. +DNSControl supports only the custom record types listed below for Bunny DNS. +Other Bunny-specific types (such as Script or Flatten) are not supported and +will be ignored by DNSControl and left as-is. ### Redirect You can configure Bunny's Redirect type with `BUNNY_DNS_RDR`: {% code title="dnsconfig.js" %} + ```javascript BUNNY_DNS_RDR("@", "https://foo.bar"), ``` + {% endcode %} ### Pull Zone (PZ) -You can configure Bunny's Pull Zone type with `BUNNY_DNS_PZ`. The target is the Pull Zone ID: +You can configure Bunny's Pull Zone type with `BUNNY_DNS_PZ`. The target is the +Pull Zone ID: {% code title="dnsconfig.js" %} + ```javascript BUNNY_DNS_PZ("@", 12345), ``` + {% endcode %} ## Caveats -- Bunny DNS does not support dual-hosting or configuring custom TTLs for NS records on the zone apex. -- While custom nameservers are properly recognized by this provider, it is currently not possible to configure them. +- Bunny DNS does not support dual-hosting or configuring custom TTLs for NS + records on the zone apex. +- While custom nameservers are properly recognized by this provider, it is + currently not possible to configure them. From 36fff06acc8e4e431208fbc7325afefc1ce39016 Mon Sep 17 00:00:00 2001 From: Tom Limoncelli Date: Tue, 9 Jun 2026 14:34:36 -0400 Subject: [PATCH 3/3] Apply suggestion from @TomOnTime --- documentation/provider/bunnydns.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/documentation/provider/bunnydns.md b/documentation/provider/bunnydns.md index d21eb64190..9528f5a8a4 100644 --- a/documentation/provider/bunnydns.md +++ b/documentation/provider/bunnydns.md @@ -53,7 +53,9 @@ Bunny supports adding CNAME records for the root domain (`@`), but within DNSControl the `ALIAS` record should be used. ```javascript -D('example.com', REG_NONE, DnsProvider(DSP_BUNNY_DNS), ALIAS('@', 'example2.com')); +D('example.com', REG_NONE, DnsProvider(DSP_BUNNY_DNS), + ALIAS('@', 'example2.com'), +); ``` ## Usage