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

# cvms list

> List CVMs

<Note>
  This command is marked as unstable and may change in future releases.
</Note>

## Command: `phala cvms list`

### Syntax

```
phala cvms list [options]
```

### Description

List CVMs

### Options

| Option                    | Description                                            |
| ------------------------- | ------------------------------------------------------ |
| `--page <value>`          | Page number (1-based)                                  |
| `--page-size <value>`     | Number of items per page                               |
| `--search <value>`        | Search by name, app\_id, vm\_uuid, or instance\_id     |
| `--status <value>`        | Filter by CVM status (can be specified multiple times) |
| `--listed, --no-listed`   | Filter by listed status                                |
| `--base-image <value>`    | Filter by base image name                              |
| `--instance-type <value>` | Filter by instance type                                |
| `--kms-type <value>`      | Filter by KMS type                                     |
| `--node <value>`          | Filter by node name                                    |
| `--region <value>`        | Filter by region identifier                            |

### Global Options

| Option                               | Description                                               |
| ------------------------------------ | --------------------------------------------------------- |
| `-h, --help`                         | Show help information for the current command             |
| `-v, --version`                      | Show CLI version                                          |
| `--api-token TOKEN, --api-key TOKEN` | API token for authenticating with Phala Cloud             |
| `-j, --json, --no-json`              | Output in JSON format                                     |
| `--interactive`                      | Enable interactive mode for commands that support it      |
| `--cvm-id <value>`                   | CVM identifier (UUID, app\_id, instance\_id, or name)     |
| `--profile PROFILE`                  | Temporarily use a different auth profile for this command |
| `--api-version <value>`              | API version to use (e.g. 2025-10-28, 2026-01-21)          |

### Examples

* List CVMs

```bash theme={"system"}
phala cvms ls
```

* Second page

```bash theme={"system"}
phala cvms ls --page 2
```

* Search by name

```bash theme={"system"}
phala cvms ls --search my-cvm
```

* Filter by status

```bash theme={"system"}
phala cvms ls --status running
```

* Output as JSON

```bash theme={"system"}
phala cvms ls --json
```