> For the complete documentation index, see [llms.txt](https://docs.rumi.systems/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rumi.systems/rumi-cli/commands/cloud/civo/list-instances.md).

# list-instances

List the instances in a Rumi network.

## Syntax

```bash
rumi cloud civo list-instances \
  --api-key <token> \
  --region <region> \
  --network <network>
```

## Options

| Option      | Short | Description                                                  | Default  |
| ----------- | ----- | ------------------------------------------------------------ | -------- |
| `--api-key` | `-k`  | The Civo API token to use (or set `CIVO_API_TOKEN`)          | Required |
| `--region`  | `-r`  | The Civo region in which to list the instances (e.g. `FRA1`) | Required |
| `--network` | `-n`  | The name of the network in which to list the instances       | Required |

## Example

```bash
rumi cloud civo list-instances \
  --api-key $CIVO_API_TOKEN \
  --region FRA1 \
  --network my-cloud
```

## See Also

* [launch-instance](/rumi-cli/commands/cloud/civo/launch-instance.md)
* [terminate-instance](/rumi-cli/commands/cloud/civo/terminate-instance.md)
* [list-networks](/rumi-cli/commands/cloud/civo/list-networks.md)