instances ls

List instances of an app

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

Command: phala instances ls

Syntax

phala instances ls [options]

Description

List instances of an app

Options

Option	Description
--app-id <value>	App ID (hex identifier). Defaults to app_id in phala.toml.

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 instances for app in phala.toml

phala instances ls

• List instances for a specific app

phala instances ls --app-id <app-id>

• Output as JSON

phala instances ls --app-id <app-id> --json