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

# Distribution Overview

> Inspect distribution status, hostname, configuration, and lifecycle metadata from the console or API.

The **Overview** tab is your at-a-glance status for a single distribution: hostname, current state, when it was created, and basic config you can edit in place.

## Open the distribution

From the CDN workspace, click **Action → Manage** on the row for your distribution.

<Frame caption="Manage your Distribution">
  <img src="https://mintcdn.com/vidinfra/CQMF-Np8q-hh-5_t/images/cdn/13.png?fit=max&auto=format&n=CQMF-Np8q-hh-5_t&q=85&s=cad2fde24e75b6f10144a7f1616df4a8" alt="Manage your Distribution" width="1918" height="860" data-path="images/cdn/13.png" />
</Frame>

The detail dashboard opens. Pick **Overview** in the left sidebar.

<Frame caption="CDN Distribution Dashboard">
  <img src="https://mintcdn.com/vidinfra/CQMF-Np8q-hh-5_t/images/cdn/14.png?fit=max&auto=format&n=CQMF-Np8q-hh-5_t&q=85&s=166d8c6b54e113900a708a5a9af0d951" alt="CDN Distribution Dashboard" width="1918" height="862" data-path="images/cdn/14.png" />
</Frame>

## Distribution details

<Frame caption="CDN Distribution Details">
  <img src="https://mintcdn.com/vidinfra/CQMF-Np8q-hh-5_t/images/cdn/16.png?fit=max&auto=format&n=CQMF-Np8q-hh-5_t&q=85&s=6438f22cffccc7531ba84598db8916bc" alt="CDN Distribution Details" width="1042" height="335" data-path="images/cdn/16.png" />
</Frame>

| Field             | What it means                                                                          |
| ----------------- | -------------------------------------------------------------------------------------- |
| **Domain**        | The CDN hostname (system-generated or your custom one). Click **Copy Domain** to copy. |
| **Status**        | Lifecycle state — see the table below.                                                 |
| **Created On**    | Distribution creation timestamp.                                                       |
| **Last Modified** | Timestamp of the most recent config change (cache rules, headers, origin, etc.).       |

### Status values

| Status         | Meaning                         | Action                                               |
| -------------- | ------------------------------- | ---------------------------------------------------- |
| `Provisioning` | Edge config is rolling out.     | Wait — usually under a minute. Don't switch DNS yet. |
| `Deployed`     | Active everywhere.              | Safe to send traffic.                                |
| `Updating`     | A config change is propagating. | Existing traffic is unaffected.                      |
| `Disabled`     | Distribution is paused.         | The hostname returns `503` until re-enabled.         |

## Configuration

<Frame caption="CDN Distribution Configuration">
  <img src="https://mintcdn.com/vidinfra/CQMF-Np8q-hh-5_t/images/cdn/17.png?fit=max&auto=format&n=CQMF-Np8q-hh-5_t&q=85&s=6acb0de11bd6d77b38660df356c58b59" alt="CDN Distribution Configuration" width="1016" height="355" data-path="images/cdn/17.png" />
</Frame>

| Field                 | Notes                                                              |
| --------------------- | ------------------------------------------------------------------ |
| **Distribution Name** | Internal label. Changing this does not affect the public hostname. |
| **Description**       | Free-text. Use it for owner / team / runbook links.                |

## Inspect via API

```bash theme={null}
curl -sS "https://api.tenbyte.io/cdn/distributions/$DISTRIBUTION_ID" \
  -H "Authorization: Bearer $TENBYTE_API_TOKEN" | jq '{name, domain, status, last_modified}'
```

Expected:

```json theme={null}
{
  "name": "prod-web",
  "domain": "your-distribution.tenbytecdn.com",
  "status": "Deployed",
  "last_modified": "2026-05-09T10:42:11Z"
}
```

Wire this into a healthcheck so deploys block on `Deployed`.

## Quick health checks

```bash theme={null}
# 1. Edge reachable?
curl -sSI "https://$CDN_HOST/" | head -1

# 2. TLS valid?
openssl s_client -connect "$CDN_HOST:443" -servername "$CDN_HOST" </dev/null \
  2>/dev/null | openssl x509 -noout -subject -dates

# 3. HTTP/2 / HTTP/3 negotiated?
curl -sS --http2 -o /dev/null -w '%{http_version}\n' "https://$CDN_HOST/"
```

See [SSL](/docs/cdn/distributions/ssl) and [Headers](/docs/cdn/distributions/headers) for tuning.