Phala Cloud Documentation — Private AI on TEE

phala annotations [options] <args>...

Show or set CVM annotations: unmeasured key/value metadata for host-side tools

Argument	Description
`<args...>`	[cvm-id] [KEY=VALUE …]. The CVM id is optional and falls back to phala.toml; an argument containing ’=’ is a pair.

Option	Description
`--unset <value>`	Remove an annotation key (repeatable)
`--clear`	Remove every annotation
`--replace`	Make the given pairs the whole set instead of merging them

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. 2026-01-21, 2026-05-22, 2026-06-23)
`--timeout SECONDS`	Request timeout in seconds (default 60)

phala annotations app_abc123

phala annotations memory_tier=fast pin_numa=0

phala annotations app_abc123 --unset memory_tier

phala annotations app_abc123 memory_tier=fast --replace

phala annotations app_abc123 --clear