link

Link a local directory to a CVM

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