> ## Documentation Index
> Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Managing clusters with the Linode CLI
> Manage Kubernetes clusters using the Linode CLI for provisioning, listing, and deleting LKE clusters from your terminal.
Streamline your Kubernetes workflow by using the Linode CLI to provision, list, and delete LKE clusters directly from your terminal. This guide walks you through installation, configuration, and common commands.
## Prerequisites
* Python 3.x and `pip3` installed
* A Linode API Token with **Read/Write** access (create one in the [Linode Cloud Manager](https://cloud.linode.com/profile/tokens))
Make sure your API token includes `lke:read_write` scopes to manage clusters.
***
## 1. Install the Linode CLI
1. Verify `pip3` is available:
```bash theme={null}
pip3 --version
```
2. Install the Linode CLI package:
```bash theme={null}
pip3 install linode-cli
```
3. Confirm the installation:
```bash theme={null}
linode-cli --help
```
***
## 2. Configure the CLI
Authenticate the CLI with your token:
```bash theme={null}
linode-cli configure --token YOUR_API_TOKEN
```
If you omit `--token`, the CLI launches a browser flow to log in and prompts for region and default Linode type.
***
## 3. List Your LKE Clusters
Retrieve all existing Kubernetes clusters on your account:
```bash theme={null}
linode-cli lke clusters-list
```
If there are no clusters, the output will be an empty array: `[]`.
***
## 4. Create a New LKE Cluster
Use `linode-cli lke clusters-create` with the following flags:
| Flag | Description | Example |
| --------------- | --------------------------------------- | ---------------------------- |
| `--label` | Unique name for the cluster | `mycluster-01` |
| `--region` | Data center region (e.g., `us-central`) | `us-central` |
| `--k8s-version` | Kubernetes version (e.g., `1.23`) | `1.23` |
| `--node-pools` | Comma-separated pool definitions | `type=g6-standard-4,count=3` |
Example command:
```bash theme={null}
linode-cli lke clusters-create \
--label mycluster-01 \
--region us-central \
--k8s-version 1.23 \
--node-pools type=g6-standard-4,count=3
```
If you see an error like `Must be unique`, update `--label` to a name not already in use.
Successful response:
```plaintext theme={null}
id label region
61875 mycluster-01 us-central
```
***
## 5. Delete an LKE Cluster
When you no longer need a cluster, remove it with:
```bash theme={null}
linode-cli lke clusters-delete mycluster-01
```
Deleting a cluster is irreversible and will remove all associated resources.
***
## CLI Command Reference
| Command | Description |
| ---------------------------------------- | ------------------------------- |
| `linode-cli lke clusters-list` | List all LKE clusters |
| `linode-cli lke clusters-create` | Create a new Kubernetes cluster |
| `linode-cli lke clusters-delete