---
title: "Serve a private bucket"
description: "Point a distribution at an Object Storage bucket and let it read the bucket's objects, without making the bucket public."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Serve a private bucket

A distribution's origin can be an [Object Storage](/object-storage) bucket in the same
organization. The bucket stays private: only the distributions listed in its settings read it, and
its S3 URLs still need a key.

1. Create the distribution with the bucket's name as its origin. In the console, choose
   **Object Storage bucket** under **Origin**. With the CLI:

   ```sh
   ezgh cdn distributions create --name assets --origin-bucket acme-assets
   ```

   Note its ID (`cdn_…`) and its default hostname, such as `d4k2m9x0a7qpe.ezghcdn.com`.

2. Let the distribution read the bucket. In the console, open the bucket, select **Permissions**
   and add the distribution's ID under **CDN distributions**. With the CLI:

   ```sh
   ezgh objects buckets settings bkt_4k2m9x0a7qpe --cdn-distribution cdn_k2m9x0a7qpe4
   ```

   This needs `objects.buckets.update`. `--cdn-distribution` replaces the list: repeat it to keep
   distributions already there.

3. Wait for the distribution's `status` to be `deployed`, then read an object by its key:

   ```sh
   curl https://d4k2m9x0a7qpe.ezghcdn.com/images/logo.png
   ```

To serve it on your own domain, add the domain as for any distribution: see
[Put a site behind the CDN](/cdn/guides/put-a-site-behind-the-cdn).

## What is served

| Request | Answer |
| --- | --- |
| `GET` or `HEAD` of an object's key, with `Range` and conditional headers | The object |
| A key that doesn't exist | `404` |
| `/`, or any listing | `403` |
| Any other method | `403` |
| An object encrypted with a customer key | `403` |
| Any request while the bucket doesn't list the distribution | `403` |

- A path is the object's key: `/images/logo.png` reads `images/logo.png`. There is no index
  document: to answer `/` or an app's routes with `index.html`, add a rewrite, as in
  [Serve a single-page app](/cdn/guides/serve-a-single-page-app).
- The bucket and the distribution must be in the same organization. They can be in different
  projects.
- A bucket lists up to 10 distributions. Whether a listed distribution exists isn't checked.
- A bucket whose name contains a dot can't be an origin.
- Removing a distribution from the bucket's list applies to the next request.
- Requests through a distribution count toward the organization's Object Storage
  [request limit](/object-storage/limits).

## With the API

Create or replace the distribution with `origin` set to the bucket alone
([CreateDistribution](/cdn-api/CreateDistribution/)):

```json
{ "name": "assets", "origin": { "bucket": "acme-assets" } }
```

The answer's `origin` has `bucket` and the bucket's `host`, `port`, `protocol` and `hostHeader`.
A replace sends `{ "bucket": … }` again, not those four fields.

List the distribution in the bucket's settings
([UpdateBucketSettings](/objects-api/UpdateBucketSettings/)):

```json
{ "publicRead": false, "corsRules": [], "cdnDistributions": ["cdn_k2m9x0a7qpe4"] }
```

Left out of the document, `cdnDistributions` stays as it is.

Source: https://docs.ezghcloud.com/cdn/guides/serve-a-private-bucket/index.mdx
