> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phala.com/llms.txt
> Use this file to discover all available pages before exploring further.

# annotations

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

### Command: `phala annotations`

#### Syntax

```
phala annotations [options] <args>...
```

#### Description

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

#### Arguments

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

#### Options

| 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 |

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

#### Examples

* Show annotations

```bash theme={"system"}
phala annotations app_abc123
```

* Set annotations (CVM from phala.toml)

```bash theme={"system"}
phala annotations memory_tier=fast pin_numa=0
```

* Remove a key

```bash theme={"system"}
phala annotations app_abc123 --unset memory_tier
```

* Replace the whole set

```bash theme={"system"}
phala annotations app_abc123 memory_tier=fast --replace
```

* Remove every annotation

```bash theme={"system"}
phala annotations app_abc123 --clear
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.