> ## Documentation Index
> Fetch the complete documentation index at: https://bunny.net/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Configure the bunny.net cPanel plugin settings including API keys, nameservers, and logging.

The bunny.net cPanel plugin uses a configuration file located at `/etc/bunnynet.conf`. This file is created automatically during setup, but you can edit it to customize the plugin behavior.

## Configuration file

```bash theme={null}
/etc/bunnynet.conf
```

After making changes to the configuration file, restart the daemon:

```bash theme={null}
systemctl restart bunnynet-cpanel-daemon
```

## Required settings

| Key | Description |
| :- | :- |
| `BUNNYNET_API_KEY` | Your bunny.net account API key. Available in [dash.bunny.net](https://dash.bunny.net/account/api-key). |
| `WHM_API_KEY` | The WHM API token. Automatically generated during setup. Managed in **WHM > Development > Manage API Tokens**. |

## Optional settings

| Key | Description | Default value |
| :- | :- | :- |
| `NS1` | Primary nameserver | `kiki.bunny.net` |
| `NS2` | Secondary nameserver | `coco.bunny.net` |
| `SOA_EMAIL` | SOA email address | `hostmaster@bunny.net` |
| `DOH_RESOLVER` | DNS over HTTPS resolver | `https://dns.quad9.net` |
| `LOG_LEVEL` | Log level (`debug`, `info`, `warn`, `error`) | `warn` |
| `URL_PURGE_WORKERS` | Number of workers for URL cache purging | `2` |

## DNS cluster settings

The DNS cluster configuration is available in **WHM > Clusters > DNS Cluster**. In addition to the API key, you can enable:

* **Sync all DNS zones** — Automatically synchronize all existing DNS zones to the cluster. Enable this if you want all DNS zones to be pushed to Bunny DNS.

![DNS Cluster configuration](https://mintcdn.com/bunnynet-cb9733c2/C-0kA-fJwModHRgU/images/integrations/cpanel/dns-cluster-config.png?fit=max\&auto=format\&n=C-0kA-fJwModHRgU\&q=85\&s=5d220ceea3d9ad70de8bf0a16ef58baa)

## Hosting packages

You can configure bunny.net features per hosting package in **WHM > Packages > Edit a Package**. The following options are available under the **bunny.net** section:

* **Max bunny.net websites** — Limit the number of websites that can use bunny.net per account
* **Bunny Optimizer** — Allow users to enable and manage Bunny Optimizer
* **Bunny Shield** — Allow users to manage DDoS protection and WAF

> [!WARNING]
>
> Make sure to set **Max bunny.net websites** to at least `1`. Setting it to `0` will prevent customers on that package from enabling bunny.net for any of their websites. Use `-1` for unlimited.

![Hosting package configuration](https://mintcdn.com/bunnynet-cb9733c2/kcU5tb-Sz5318NF5/images/integrations/cpanel/whm_package_limited.png?fit=max\&auto=format\&n=kcU5tb-Sz5318NF5\&q=85\&s=d94ac5b37cf80257c92f3fd3da36faee)

## Hiding the plugin for certain packages

If you want to hide the bunny.net plugin from customers on specific packages, you can use WHM's Feature Manager to create a feature list that excludes it.

**1. Create a feature list**

In WHM, go to **Packages > Feature Manager**. Create a new feature list or edit an existing one.

**2. Disable the bunny.net feature**

In the feature list, uncheck **bunny.net** to hide the plugin from cPanel for customers using this feature list.

**3. Assign the feature list to a package**

Go to **Packages > Edit a Package**, select the package you want to restrict, and set the **Feature List** to the one you created.

Customers on packages with this feature list will no longer see the bunny.net plugin in their cPanel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.