Skip to main content

​
Usage

phala apps [options]

​
Options

FlagDefaultDescription
--page <number>1Page number for pagination
--page-size <number>50Number of items per page (max: 100)
--search <query>Search by name, app_id, vm_uuid, or instance_id
--status <status>Filter by CVM status (repeatable)
--listedFilter to only listed CVMs
--no-listedFilter to only unlisted CVMs
--base-image <name>Filter by base OS image name
--instance-type <type>Filter by instance type
--kms-type <type>Filter by KMS type (phala, ethereum, base)
--node <name>Filter by node name
--region <region>Filter by region
-j, --jsonfalseOutput in JSON format

​
CVM Status Values

Common status values for filtering:
  • pending - CVM is being created
  • starting - CVM is starting up
  • running - CVM is running normally
  • stopped - CVM has been stopped
  • error - CVM encountered an error
  • terminated - CVM has been terminated

​
Examples

​
List all CVMs

$ phala apps
CVMs (3 total):

  app_abc123  my-production-app   running   tdx.medium  us-west
  app_def456  staging-api         running   tdx.small   us-east
  app_ghi789  test-app            stopped   tdx.small   eu-central

​
Search by name

$ phala apps --search production
CVMs (1 total):

  app_abc123  my-production-app   running   tdx.medium  us-west

​
Filter by status

$ phala apps --status running
CVMs (2 total):

  app_abc123  my-production-app   running   tdx.medium  us-west
  app_def456  staging-api         running   tdx.small   us-east

​
Filter by multiple statuses

$ phala apps --status running --status starting

​
Filter by instance type

$ phala apps --instance-type tdx.medium

​
Filter by region

$ phala apps --region us-west

​
JSON output

$ phala apps --json
{
  "apps": [
    {
      "app_id": "app_abc123",
      "name": "my-production-app",
      "status": "running",
      "instance_type": "tdx.medium",
      "region": "us-west",
      "vcpu": 4,
      "memory_gb": 8,
      "created_at": "2026-01-15T10:30:00Z",
      "url": "https://app_abc123.phala.cloud"
    }
  ],
  "total": 3,
  "page": 1,
  "page_size": 50
}

​
Pagination

$ phala apps --page 2 --page-size 10

​
Combine multiple filters

$ phala apps --status running \
  --instance-type tdx.medium \
  --region us-west