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

# instances

> Manage app instances

<Note>
  This command is marked as unstable and may change in future releases.
</Note>

### Command: `phala instances`

#### Syntax

```
phala instances <command> [options]
```

#### Description

Manage app instances

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

* Display help:

```bash theme={"system"}
phala instances --help
```

### Subcommands

| Command | Description                                 |
| ------- | ------------------------------------------- |
| `ls`    | List instances of an app                    |
| `add`   | Create a new instance under an existing app |
| `rm`    | Delete one or more app instances by VM UUID |