> ## Documentation Index
> Fetch the complete documentation index at: https://bunnynet-cb9733c2-support-migration.mintlify.site/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).                         |
| `WHM_API_KEY`      | The WHM API token. Automatically generated during setup. Managed in **WHM > Development > Manage API Tokens**. |

## Optional settings

| Key                 | Description                                  | Default                 |
| :------------------ | :------------------------------------------- | :---------------------- |
| `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 and DNS role, you can enable:

* **Sync all DNS zones** — Automatically synchronize all existing DNS zones to the cluster. Enable this if you want all current zones to be pushed to bunny.net DNS when setting up the cluster.

<Frame>
  <img src="https://mintcdn.com/bunnynet-cb9733c2-support-migration/w32H-OuMiEPPh72G/images/integrations/cpanel/dns-cluster-config.png?fit=max&auto=format&n=w32H-OuMiEPPh72G&q=85&s=ffdd4d37c09f9786376c8e1b119a519e" alt="DNS Cluster configuration" width="1498" height="742" data-path="images/integrations/cpanel/dns-cluster-config.png" />
</Frame>

## 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** — Enable or disable image optimization for the package
* **Bunny Shield** — Enable or disable DDoS protection and WAF for the package

<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.
</Warning>

<Frame>
  <img src="https://mintcdn.com/bunnynet-cb9733c2-support-migration/w32H-OuMiEPPh72G/images/integrations/cpanel/whm_package_limited.png?fit=max&auto=format&n=w32H-OuMiEPPh72G&q=85&s=53f533cc5395f740a66239b785dbed43" alt="Hosting package configuration" width="3420" height="1870" data-path="images/integrations/cpanel/whm_package_limited.png" />
</Frame>

## 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.

<Steps>
  <Step title="Create a feature list">
    In WHM, go to **Packages > Feature Manager**. Create a new feature list or edit an existing one.
  </Step>

  <Step title="Disable the bunny.net feature">
    In the feature list, uncheck **bunny.net** to hide the plugin from cPanel for customers using this feature list.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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