> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ibee.co.in/docs/infrastructure/object-storage/cdn-integration/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ibee.co.in/_mcp/server.

# CDN Integration

> Front an IBEE Object Storage bucket with the IBEE CDN to cache and deliver content globally with low latency.

Use a CDN distribution with an **Object Storage Bucket** origin to put a global cache in front of your bucket. Static files, media, and other assets are served from edge nodes closer to your users, reducing latency and origin load.

CDN distributions are managed under **Network & Security → CDN** in the portal. For the full reference — including custom origins, every cache policy, custom domains, and troubleshooting — see [Network & Security → CDN](/docs/network-security/cdn).

## Before you begin

* An active IBEE Solutions organization ([Create an organization](/docs/getting-started/account-setup/create-a-project))
* An Object Storage bucket with files to distribute ([Create a bucket](/docs/infrastructure/object-storage/buckets))

## Front a bucket with the CDN

### 1. Open CDN

In the portal, click **CDN** in the left sidebar under **Network & Security**.

### 2. Open the Create dialog

Click **+ Create CDN**. The **Create CDN Distribution** dialog opens.

### 3. Fill in the fields

| Field               | Value                                                                   |
| ------------------- | ----------------------------------------------------------------------- |
| **Name**            | e.g. `assets-prod`                                                      |
| **Origin Type**     | **Object Storage Bucket**                                               |
| **Select a bucket** | Pick the bucket to front (use the searchable dropdown)                  |
| **Cache Policy**    | `Static Assets` for long-lived assets, or `Media Files` for video/audio |

### 4. Save

Click **Create Distribution**. The distribution is provisioned and assigned a CDN URL like `dl-{hash}.cdn.ibee.ai` with an automatic SSL certificate.

> **Info**
>
> To serve the CDN from your own hostname (e.g. `cdn.example.com`) instead of the default `dl-{hash}.cdn.ibee.ai`, create a CNAME record from your subdomain to `cname.cdn.ibee.ai`, then click **Add Domain** on the distribution's detail page — see [CDN → Custom domains](/docs/network-security/cdn#custom-domains). Don't use the bucket's own [Custom Domains](/docs/infrastructure/object-storage/buckets/custom-domains) setting for this: a bucket custom domain serves the bucket directly and bypasses the CDN cache.

## Cache policy quick reference

| Policy            | TTL     | Best for                    |
| ----------------- | ------- | --------------------------- |
| **Static Assets** | 1 year  | Images, fonts, CSS, JS      |
| **Media Files**   | 30 days | Video and audio             |
| **Short Cache**   | 1 hour  | Frequently changing content |
| **No Cache**      | None    | Always fetches from origin  |

See [Network & Security → CDN](/docs/network-security/cdn#choose-a-cache-policy) for full details.

## Related pages

* [Network & Security → CDN](/docs/network-security/cdn)
* [Buckets](/docs/infrastructure/object-storage/buckets)
* [Custom Domains](/docs/infrastructure/object-storage/buckets/custom-domains)
* [Bucket policies](/docs/infrastructure/object-storage/buckets/bucket-policies)

> Front an IBEE Object Storage bucket with the IBEE CDN to cache and deliver content globally with low latency.