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

# Custom Domains

> Serve IBEE Object Storage bucket content from your own domain by adding a CNAME record and verifying your hostname in the bucket settings.

Custom domains let you serve bucket content from your own hostname (e.g. `cdn.example.com`) instead of the default IBEE Public Access URL. You add a CNAME record in your DNS provider, then register the domain in the bucket settings.

## Before you begin

* An active IBEE Solutions organization with a verified account
* A bucket ([Create a bucket](/docs/infrastructure/object-storage/buckets))
* **Public Access enabled on the bucket** — see [Bucket policies → Public access](/docs/infrastructure/object-storage/buckets/bucket-policies#public-access)
* Access to your domain's DNS settings

> **Warning**
>
> **The bucket must be public to configure a custom domain.** If Public Access is disabled, the Custom Domains tab shows the error *"Bucket must be public to configure custom domain"* and the CNAME target shown under Step 1 will be `Unavailable`.

> **Info**
>
> **Custom domains are a billable add-on.** When you click **Add Domain**, the portal first checks your organization's billing status. If your wallet balance or credit limit can't cover the add-on, a billing message appears instead of the **Add Custom Domain** dialog — add credits and try again.

## Add a custom domain

### Open bucket settings

Open your bucket in the portal, click the **Settings** tab, then click **Custom Domains**.

### Add a domain

Click **+ Add Domain**. The **Add Custom Domain** modal appears with the subtitle *"Connect your bucket to a custom domain."*

### Add the CNAME record (Step 1)

The modal's **Step 1** shows the field *"Add a CNAME record in your DNS pointing to:"* with the CNAME target. Click **Copy** to copy the target:

```
{hash}.ibee.zone
```

Go to your DNS provider and add a CNAME record:

| Type  | Host                      | Value                                   |
| ----- | ------------------------- | --------------------------------------- |
| CNAME | `cdn` (or your subdomain) | `{hash}.ibee.zone` (copied from portal) |

> **Info**
>
> DNS propagation can take some time before verification succeeds. Wait for propagation to complete before proceeding to Step 2.

### Enter your domain (Step 2)

After adding the CNAME record, enter your full domain in the **Step 2** field — *"Enter your domain after the CNAME record is added."* Placeholder: `cdn.example.com`.

```
cdn.example.com
```

### Save

Click **Add Domain**. The domain appears in the **Custom Domains** list with a status:

| Status                       | Meaning                                                                                                  |
| ---------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Pending DNS Verification** | Waiting for the CNAME record to resolve to the target.                                                   |
| **Provisioning SSL**         | DNS is verified; the HTTPS certificate is being issued.                                                  |
| **Active**                   | The domain is serving bucket content over HTTPS.                                                         |
| **Error**                    | Setup failed. Check the CNAME record; if the status doesn't recover, remove the domain and add it again. |

To stop serving from a domain, click **Remove** next to it in the list and confirm.

## Troubleshooting

**Verification fails immediately after adding the domain**
DNS propagation takes time. Wait a few minutes after adding the CNAME record, then try again.

**CNAME record not resolving**
Verify the CNAME record is saved correctly in your DNS provider. The record value must exactly match the target shown in the portal.

**Domain stays in Pending DNS Verification**
Ensure the CNAME points to the full target including `.ibee.zone`. Some DNS providers strip the trailing dot — confirm the value is saved as shown.

**CNAME target shows `Unavailable`**
The bucket is not public. Enable Public Access first — see [Bucket policies → Public access](/docs/infrastructure/object-storage/buckets/bucket-policies#public-access).

## Related

* [Buckets](/docs/infrastructure/object-storage/buckets)
* [Bucket policies](/docs/infrastructure/object-storage/buckets/bucket-policies)
* [CDN integration](/docs/infrastructure/object-storage/cdn-integration)
* [Static Site Hosting](/docs/infrastructure/object-storage/static-site-hosting)