> 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/hetzner/list-instances.md).

# list-instances

List the platform and service instances in a network.

## Syntax

```bash
rumi cloud hetzner list-instances \
  --api-key <token> \
  --network <network> \
  [options]
```

## Options

| Option      | Short | Description                                                 | Default  |
| ----------- | ----- | ----------------------------------------------------------- | -------- |
| `--api-key` | `-k`  | The Hetzner Cloud project API token (or set `HCLOUD_TOKEN`) | Required |
| `--region`  | `-r`  | The Hetzner location the network is in                      | `fsn1`   |
| `--network` | `-n`  | The name of the network                                     | Required |

## Example

```bash
rumi cloud hetzner list-instances --api-key $HCLOUD_TOKEN --network my-cloud
```

## Notes

* Prints the platform instances (roles) and the service (worker) instances separately.

## See Also

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