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

# Images

> CLI reference for managing images and snapshots.

## images ls

```bash theme={"theme":"css-variables"}
machine0 images ls
machine0 images ls --json
```

***

## images get

```bash theme={"theme":"css-variables"}
machine0 images get <image>
```

***

## images new

Snapshot a VM into a reusable image. The VM is stopped automatically before snapshotting.

```bash theme={"theme":"css-variables"}
machine0 images new <vm> <image> [flags]
```

| Flag                | Description                   |
| ------------------- | ----------------------------- |
| `-d, --description` | Image description             |
| `-m, --metadata`    | JSON metadata for the version |

***

## images update

```bash theme={"theme":"css-variables"}
machine0 images update <image> [flags]
```

| Flag                | Description             |
| ------------------- | ----------------------- |
| `-n, --name`        | New name                |
| `-d, --description` | New description         |
| `-r, --region`      | Comma-separated regions |

***

## images rm

```bash theme={"theme":"css-variables"}
machine0 images rm [image] [flags]
```

| Flag        | Description       |
| ----------- | ----------------- |
| `-a, --all` | Delete all images |
| `-y, --yes` | Skip confirmation |