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

# Custom Hostname

> Serve content from your own branded domain like cdn.yourdomain.com.

Use a custom hostname to serve CDN content from your own domain instead of the default bunny.net URL.

**1. Add the hostname to your pull zone**

1. Open your pull zone in the [dashboard](https://dash.bunny.net)
2. Locate the **Hostnames** panel in the General section
3. Enter your custom domain (e.g., `cdn.yourdomain.com`)
4. Click **Add hostname**

![Add custom hostname](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/add-a-custom-hostname.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=a0a71b2b488354d72247c1aa33587041)

The hostname appears in the Linked Hostnames list.

**2. Copy the CNAME record**

Copy the CNAME record value shown below the hostname field. You'll need this for the next step.

![Copy custom hostname CNAME](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/copy-custom-hostname-cname.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=011e53191b962ce52d18b39a0c00bbb5)

**3. Update your DNS settings**

Add a CNAME record at your DNS provider:

1. Log in to your DNS provider (Cloudflare, Route 53, or similar)
2. Create a new **CNAME** record:
   * **Name/Host**: Your subdomain (e.g., `cdn`)
   * **Type**: CNAME
   * **Value**: The CNAME from step 2 (e.g., `yourzone.b-cdn.net`)
   * **TTL**: 3600 seconds or lower

> [!WARNING]
>
> On Cloudflare, disable the proxy option (orange cloud icon). Proxying interferes with DNS resolution and prevents your custom domain from working with bunny.net.

**4. Wait for DNS propagation**

Save the DNS record. Your domain connects to bunny.net once DNS propagates, typically within a few minutes to an hour.

**5. Enable SSL**

Click **Verify & Activate SSL** to get a free Let's Encrypt certificate for your custom hostname.

![Verify and activate SSL](https://mintcdn.com/bunnynet-cb9733c2/GYo51EPI6zuebYhU/images/cdn/verify-and-active-ssl-custom-hostname.png?fit=max\&auto=format\&n=GYo51EPI6zuebYhU\&q=85\&s=f8928d71336f40148362bcaf795a2e05)

> [accordion] Enable SSL later
>
> If you skip SSL verification initially, find your hostname in the **Linked Hostnames** section and click **Enable** to activate a free certificate or upload your own.
>
> ![Enable custom hostname SSL](https://mintcdn.com/bunnynet-cb9733c2/1bTPx1eyQm8EK8W3/images/cdn/enable-custom-hostname-ssl.png?fit=max\&auto=format\&n=1bTPx1eyQm8EK8W3\&q=85\&s=27c082435b29c9805f4af5fa9eb6b5ad)

## Root domains

CNAME records cannot be created at the apex level (`yourdomain.com`) per the DNS specification. Most DNS providers don't support non-standard record types like ALIAS or ANAME that work around this limitation.

> [!WARNING]
>
> Pull Zones do not support direct IP address connections. There is no stable
> anycast IP that can be used with A records to point a domain to a Pull Zone.
> You can use a direct IP as the origin with a custom Host header, but pointing
> an A record to a specific Bunny IP is not supported. See [How to set up a
> direct IP origin URL](https://bunny.net/docs/cdn/edge-rules/ip-origin.md) for more information.

To use a root domain with your Pull Zone, you have two options:

1. **Use Bunny DNS (recommended)**: Bunny DNS supports CNAME flattening on apex domains, allowing you to point your root domain directly to a Pull Zone. See [CDN Acceleration](https://bunny.net/docs/cdn/cdn-acceleration.md) for setup instructions.

2. **Redirect apex to www**: Create a CNAME for `www.yourdomain.com` pointing to your Pull Zone, then set up an HTTP redirect from your root domain to `www`.


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