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

# cluster

> Show the Entire clusters you can place projects and repositories on.

Show the Entire clusters you can place projects and repos on.

```bash theme={null}
entire cluster SUBCOMMAND
```

A cluster is one regional EntireDB deployment. Clusters are where [repositories](/cli-reference/repo.md) are provisioned and where [mirror placements](/guides/repositories/mirrors.md) live, and their public hosts are what `--cluster` accepts elsewhere in the CLI.

## cluster list

List the clusters Entire has available.

```bash theme={null}
entire cluster list [flags]
```

The table shows three columns, each a value another command takes: `REGION` is the jurisdiction slug [`entire org create --region`](/cli-reference/org) and [`entire project create --region`](/cli-reference/project) name, `CLUSTER` is the cluster's placement slug, and `HOST` is what every `--cluster` flag takes, including the [`entire repo mirror list --cluster`](/cli-reference/repo#entire-repo-mirror-list) filter.

A `DEFAULT` column appears only when some cluster is not its region's default. It marks the default within each region, not one global default.

Pass the `HOST` value — such as `aws-us-east-2.entire.io`, not the region or slug — to [`entire repo mirror add --cluster`](/cli-reference/repo#entire-repo-mirror-add), [`entire repo mirror list --cluster`](/cli-reference/repo#entire-repo-mirror-list), [`entire repo clone --cluster`](/cli-reference/repo#entire-repo-clone), and [`entire repo remote add --cluster`](/cli-reference/repo#entire-repo-remote-add). [`entire auth status`](/cli-reference/auth#auth-status) shows your home jurisdiction.

```bash theme={null}
entire cluster list
entire cluster list --json
```

| Flag | Description |
| - | - |
| `--json` | Output raw JSON instead of a table. |

## Continue With

> **[repo](/cli-reference/repo.md)**
>
> Create repositories and mirror placements on a cluster.

> **[Mirrors](/guides/repositories/mirrors.md)**
>
> Understand how regional placements work.
