> ## Documentation Index
> Fetch the complete documentation index at: https://porter-mintlify-a87355a5.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# porter cluster

> List available clusters, view cluster configuration details, and manage namespace settings using the Porter Enterprise CLI cluster commands

##### Prerequisites

* You've logged in to the Porter CLI after running [porter auth login](/enterprise/cli/command-reference/porter-auth)
* You're connected to the correct project by running [porter config set-project](/enterprise/cli/command-reference/porter-config)

`porter cluster` contains commands for reading from a connected cluster.

### `porter cluster list`[](#porter-cluster-list "Direct link to heading")

This lists all clusters under a certain project. The default output renders a formatted table with each cluster's name, provider, region, status, and creation date, with the name hyperlinked to its dashboard page in supported terminals.

**Flags:**

| Flag     | Description                                                                                   |
| -------- | --------------------------------------------------------------------------------------------- |
| `--json` | Print clusters as JSON instead of a table. Useful for piping into tools like `jq` in scripts. |

**Example:**

```bash theme={null}
porter cluster list --json | jq '.[].name'
```

### `porter cluster namespace list`[](#porter-cluster-namespace-list "Direct link to heading")

This lists all namespace in a cluster. This is a good mechanism to check that you are properly authenticated to a cluster.