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

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

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

    <Frame>
      <img src="https://mintcdn.com/bunnynet-cb9733c2-support-migration/7nPf1p6kEqFGPtU3/images/cdn/add-a-custom-hostname.png?fit=max&auto=format&n=7nPf1p6kEqFGPtU3&q=85&s=8bd4b24cbe32497d99e8e837b2690854" alt="Add custom hostname" width="1570" height="456" data-path="images/cdn/add-a-custom-hostname.png" />
    </Frame>

    The hostname appears in the Linked Hostnames list.
  </Step>

  <Step title="Copy the CNAME record">
    Copy the CNAME record value shown below the hostname field. You'll need this for the next step.

    <Frame>
      <img src="https://mintcdn.com/bunnynet-cb9733c2-support-migration/7nPf1p6kEqFGPtU3/images/cdn/copy-custom-hostname-cname.png?fit=max&auto=format&n=7nPf1p6kEqFGPtU3&q=85&s=0eb6b877bef92a38cc570c1589242a6a" alt="Copy custom hostname CNAME" width="858" height="960" data-path="images/cdn/copy-custom-hostname-cname.png" />
    </Frame>
  </Step>

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

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

  <Step title="Enable SSL">
    Click **Verify & Activate SSL** to get a free Let's Encrypt certificate for your custom hostname.

    <Frame>
      <img src="https://mintcdn.com/bunnynet-cb9733c2-support-migration/Z09ZI7FyatCuoSuT/images/cdn/verify-and-active-ssl-custom-hostname.png?fit=max&auto=format&n=Z09ZI7FyatCuoSuT&q=85&s=caef285deb61f2bc1e4e9675f410e655" alt="Verify and activate SSL" width="858" height="960" data-path="images/cdn/verify-and-active-ssl-custom-hostname.png" />
    </Frame>

    <Accordion title="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.

      <Frame>
        <img src="https://mintcdn.com/bunnynet-cb9733c2-support-migration/7nPf1p6kEqFGPtU3/images/cdn/enable-custom-hostname-ssl.png?fit=max&auto=format&n=7nPf1p6kEqFGPtU3&q=85&s=f11626fdb9cc6ecb1b2a22ff33a3d5a5" alt="Enable custom hostname SSL" width="1566" height="446" data-path="images/cdn/enable-custom-hostname-ssl.png" />
      </Frame>
    </Accordion>
  </Step>
</Steps>

## 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](/cdn/edge-rules/ip-origin) for more information.
</Warning>

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](/cdn/cdn-acceleration) 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`.