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

# os-images

> List available OS images

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

### Command: `phala os-images`

#### Syntax

```
phala os-images [options]
```

#### Description

List available OS images

#### Options

| Option                | Description              |
| --------------------- | ------------------------ |
| `--dev`               | Show only dev images     |
| `--prod`              | Show only prod images    |
| `--page <value>`      | Page number (1-indexed)  |
| `--page-size <value>` | Items per page (max 100) |
| `--all`               | Fetch all pages          |

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

* List all OS images

```bash theme={"system"}
phala os-images
```

* List prod images only

```bash theme={"system"}
phala os-images --prod
```

* List page 2 with page size 20

```bash theme={"system"}
phala os-images --page 2 --page-size 20
```

* Fetch all pages

```bash theme={"system"}
phala os-images --all
```

* Output as JSON

```bash theme={"system"}
phala os-images --json
```