---
sidebar_position: 25
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lium.io/llms.txt
> Use this file to discover all available pages before exploring further.
>
> Lium (lium.io) is a GPU rental marketplace: rent NVIDIA GPUs by the hour, billed per second.

# `lium clusters`

Rent several whole nodes on one InfiniBand, RoCE or AWS EFA fabric as one cluster. See [Multi-node clusters](/pod-users/clusters) for how to run a job on it.

Every subcommand takes `--format table|json` (or `--json`).

## `lium clusters list`

List fabrics with free nodes. Plain `lium clusters` does the same.

**Usage**

```bash
lium clusters list [OPTIONS]
```

**Example**

```bash
lium clusters
```

## `lium clusters up`

Rent N whole nodes of one fabric, all or nothing. The cluster bills from the moment the rent succeeds.

**Usage**

```bash
lium clusters up FABRIC --nodes N --name NAME [OPTIONS]
```

**Flags**

| Flag | What it does |
|------|--------------|
| `FABRIC` | Row number from `lium clusters`, or a fabric id |
| `-N`, `--nodes N` | Number of nodes, at least `2` (required) |
| `-n`, `--name NAME` | Pod name for every member (required) |
| `-t`, `--template_id ID` | Template (default: the newest cluster template) |
| `-p`, `--ports N` | Ports to expose per node |
| `--ttl DURATION` | Remove every member after this long, e.g. `12h` |
| `--no-backup` | Do not back up the members' volumes (backups are on by default) |
| `--wait` / `--no-wait` | Wait until every member is running (default: wait) |
| `--timeout SECONDS` | How long to wait (default `900`) |
| `-y`, `--yes` | Rent without asking |

**Example**

```bash
lium clusters up 1 --nodes 2 --name job --ttl 12h
```

## `lium clusters ps`

List your clusters.

**Usage**

```bash
lium clusters ps [OPTIONS]
```

**Example**

```bash
lium clusters ps
```

## `lium clusters show`

Show a cluster's members: rank, overlay IP, GPUs and SSH command.

**Usage**

```bash
lium clusters show CLUSTER [OPTIONS]
```

**Flags**

| Flag | What it does |
|------|--------------|
| `CLUSTER` | Cluster id or the shared pod name |
| `--hostfile` | Print only an `mpirun`/DeepSpeed hostfile |
| `--torchrun RANK` | Print only the `torchrun` flags for this rank |

**Example**

```bash
lium clusters show job --hostfile
```

## `lium clusters rm`

Remove every member of a cluster.

**Usage**

```bash
lium clusters rm CLUSTER [OPTIONS]
```

**Flags**

| Flag | What it does |
|------|--------------|
| `CLUSTER` | Cluster id or the shared pod name |
| `-y`, `--yes` | Remove without asking |

**Example**

```bash
lium clusters rm job -y
```
