dnscontrol/documentation/provider/bunny_dns.md
2024-04-18 09:43:50 -04:00

1.7 KiB

Configuration

To use this provider, add an entry to creds.json with TYPE set to BUNNY_DNS along with your Bunny API Key.

Example:

{% code title="creds.json" %}

{
  "bunny_dns": {
    "TYPE": "BUNNY_DNS",
    "api_key": "your-bunny-api-key"
  }
}

{% endcode %}

You can also use environment variables:

export BUNNY_DNS_API_KEY=XXXXXXXXX

{% code title="creds.json" %}

{
  "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.

Usage

An example configuration:

{% code title="dnsconfig.js" %}

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")
);

{% endcode %}

Activation

DNSControl depends on the Bunny API to manage your DNS records. You will need to generate an API key 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.

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.
  • Any custom record types like Script, Redirect, Flatten or Pull Zone are currently not supported by this provider. Such records will be completely ignored by DNSControl and left as-is.