Phala Cloud Documentation — Confidential AI on TEE

This command is marked as unstable and may change in future releases.

Command: `phala cvms list`

phala cvms list [options]

List CVMs

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

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)

phala cvms ls

phala cvms ls --page 2

phala cvms ls --search my-cvm

phala cvms ls --status running

phala cvms ls --json