porter cluster

List clusters and view cluster details including node groups, Kubernetes version, cloud provider configuration, and status using the Porter CLI

porter cluster contains commands for viewing and managing clusters.

Prerequisites

• You’ve logged in to the Porter CLI after running porter auth login
• You’re connected to the correct project by running porter config set-project

---

porter cluster list

List all clusters in the current project. The default output renders a formatted table with the cluster name, provider, region, status, and creation date. Cluster names are hyperlinked to their dashboard page in supported terminals.

Usage:

porter cluster list

Flags:

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

Example:

porter cluster list --json | jq '.[].name'

Use porter config set-cluster to switch between clusters after listing them.

---

Related Commands

• porter config set-cluster - Set the active cluster
• porter project list - List available projects