Phala Cloud Documentation — Confidential AI on TEE

This command is deprecated. See the newer alternatives.

Command: phala cvms upgrade

Syntax

phala cvms upgrade [options] [<cvm_id>]

Description

Upgrade a CVM to a new version (use “phala deploy” instead)

Arguments

Argument	Description
`<cvm_id>?`	CVM identifier (UUID, app_id, instance_id, or name)

Options

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
`-i, --interactive`	Enable interactive mode
`--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

Upgrade a CVM interactively

phala cvms upgrade

Upgrade using a compose file

phala cvms upgrade app_123 --compose ./docker-compose.yml

cvms upgrade (Deprecated)