Phala Cloud Documentation — Confidential AI on TEE

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

Command: `phala link`

Syntax

phala link [options] [<cvm-id>]

Description

Link a local directory to a CVM.

As of v1.1.18, phala link supports linking by a 40-character hex app_id (resolved via the /apps/ endpoint). After authentication, the CLI prints the workspace name and slug so you can confirm the target context before the link is written.

Arguments

Argument	Description
`<cvm-id>?`	CVM ID or name (interactive if omitted)

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

Link by name or ID

phala link my-cvm-name

Link interactively

phala link

envs update simulator start

​Command: phala link

​Syntax

​Description

​Arguments

​Global Options

​Examples

Command: `phala link`

Syntax

Description

Arguments

Global Options

Examples