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

# qovery cluster

> Cluster management commands

## Overview

View and manage Kubernetes clusters in your Qovery organization.

## Commands

### List Clusters

List all clusters in current organization:

```bash theme={null}
qovery cluster list
```

### Cluster Status

Get detailed cluster status:

```bash theme={null}
qovery cluster status --cluster "cluster-id"
```

### Cluster Info

Get cluster information:

```bash theme={null}
qovery cluster info --cluster "cluster-id"
```

### Download Kubeconfig

Download kubeconfig file for kubectl access:

```bash theme={null}
qovery cluster kubeconfig --cluster-id "cluster-id"
```

This command generates a kubeconfig file that allows you to connect to your cluster using kubectl.

### Open Debug Pod

Launch an interactive debug pod with kubectl pre-configured:

```bash theme={null}
qovery cluster debug-pod \
  --organization-id "org-id" \
  --cluster-id "cluster-id"
```

This opens a debug shell inside your cluster with kubectl access, perfect for troubleshooting.

## Options

| Flag             | Description                       |
| ---------------- | --------------------------------- |
| `--cluster`      | Cluster ID or name                |
| `--organization` | Organization ID or name           |
| `--output`       | Output format (table, json, yaml) |
| `--help`         | Show help                         |

## Examples

### List All Clusters

```bash theme={null}
# Set organization context
qovery context set --organization "My Org"

# List clusters
qovery cluster list

# Example output:
# NAME           REGION        CLOUD     STATUS    VERSION
# prod-us-east   us-east-1     AWS       Running   1.28
# staging-eu     eu-west-1     AWS       Running   1.27
```

### Check Cluster Status

```bash theme={null}
# Get detailed status
qovery cluster status --cluster "prod-us-east"

# Get JSON output
qovery cluster status \
  --cluster "prod-us-east" \
  --format json
```

### View Cluster Details

```bash theme={null}
# Get cluster info
qovery cluster info --cluster "prod-us-east"
```

### Get kubectl Access

```bash theme={null}
# Download kubeconfig file
qovery cluster kubeconfig --cluster-id "abc123"

# Set kubectl to use the downloaded config
export KUBECONFIG=./kubeconfig-abc123.yaml

# Test connection
kubectl get nodes
```

### Open Debug Pod for Troubleshooting

```bash theme={null}
# Launch debug pod
qovery cluster debug-pod \
  --organization-id "org-abc123" \
  --cluster-id "cluster-abc123"

# Inside the debug pod, you can run kubectl commands:
# kubectl get pods --all-namespaces
# kubectl logs <pod-name> -n <namespace>
# exit
```

## Cluster Status Values

| Status      | Description               |
| ----------- | ------------------------- |
| `RUNNING`   | Cluster is operational    |
| `DEPLOYING` | Cluster is being deployed |
| `WARNING`   | Cluster has warnings      |
| `ERROR`     | Cluster has errors        |
| `DELETING`  | Cluster is being deleted  |

## Tips

<Tip>
  Use cluster commands to verify cluster health before deploying applications.
</Tip>

<Tip>
  Check cluster status regularly to ensure your infrastructure is healthy.
</Tip>

<Tip>
  Use `qovery cluster kubeconfig` to get full kubectl access to your cluster for advanced operations.
</Tip>

<Tip>
  The `debug-pod` command is perfect for quick troubleshooting without needing to configure kubectl locally.
</Tip>

## Related Commands

* [`qovery context`](/cli/commands/context) - Set cluster context
* [`qovery environment`](/cli/commands/environment) - Manage environments on cluster
* [`qovery shell`](/cli/commands/shell) - Open shell in application container

## Related Documentation

* [Connect to EKS with kubectl](/integrations/kubernetes/eks/kubectl-access) - Comprehensive guide for kubectl access