> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/cli/compute/images.md).

# Images

Images are operating system or application disk images used to boot instances. AceCloud provides a catalog of public images and supports user-created (private) images from snapshots and saves.

**Command:** `ace image`

***

## Table of Contents

* [List Images](#list-images)
* [Get Image Details](#get-image-details)
* [Delete Images](#delete-images)
* [Image Categories](#image-categories)

***

## List Images

List all available images in the current region.

```bash
ace image list
```

**Aliases:** `ls`

### Filters

| Flag         | Description                                                               |
| ------------ | ------------------------------------------------------------------------- |
| `--os`       | Filter by operating system (e.g. `ubuntu`, `centos`, `windows`, `debian`) |
| `--category` | Filter by image category                                                  |

### Examples

```bash
# List all images
ace image list

# Filter by OS
ace image list --os ubuntu
ace image list --os centos

# Filter by category
ace image list --category "Linux"

# JSON output
ace image list -o json
```

### Table Output

```
ID                                     NAME                                STATUS         SIZE VISIBILITY
abc12345-1234-1234-1234-123456789abc   Ubuntu-22.04-LTS                    active       2.5 GB public
def67890-1234-1234-1234-123456789abc   Ubuntu-24.04-LTS                    active       2.8 GB public
111aaaaa-2222-3333-4444-555555555555   CentOS-9-Stream                     active       1.9 GB public
```

***

## Get Image Details

Get detailed information about a specific image. Accepts either an image name or UUID.

```bash
ace image get <image-name-or-id>
```

**Aliases:** `show`, `describe`

### Examples

```bash
# By name
ace image get Ubuntu-22.04-LTS

# By UUID
ace image get abc12345-1234-1234-1234-123456789abc

# JSON output
ace image get Ubuntu-22.04-LTS -o json
```

### Detail Output

```
ID:                  abc12345-1234-1234-1234-123456789abc
Name:                Ubuntu-22.04-LTS
Status:              active
Visibility:          public
Size:                2.5 GB
Virtual Size:        10.0 GB
Disk Format:         qcow2
Container Format:    bare
Min Disk:            20 GB
Min RAM:             512 MB
Created:             2024-01-15T10:30:00Z
Updated:             2024-06-20T14:45:00Z
Tags:                [ubuntu, lts, 22.04]
```

***

## Delete Images

Delete one or more images. Accepts image names or UUIDs. Names are automatically resolved to UUIDs.

```bash
# Delete a single image
ace image delete <image-name-or-id>

# Delete multiple images
ace image delete <image-1> <image-2> <image-3>
```

**Aliases:** `rm`

```bash
# Delete by name
ace image delete my-custom-image

# Delete by UUID
ace image delete abc12345-1234-1234-1234-123456789abc

# Delete multiple
ace image delete old-snapshot-1 old-snapshot-2
```

You can only delete images that belong to your project (private/shared visibility). Public images provided by AceCloud cannot be deleted.

***

## Image Categories

List all available image categories. Categories group images by OS family or purpose.

```bash
ace image categories
```

### Example Output

```
ID                                     NAME                      DESCRIPTION
aaa11111-2222-3333-4444-555555555555   Linux                     Linux-based operating systems
bbb11111-2222-3333-4444-555555555555   Windows                   Windows Server images
ccc11111-2222-3333-4444-555555555555   Application               Pre-configured application images
```

Use a category ID or name with the `--category` flag on `ace image list`:

```bash
ace image list --category Linux
```

***

## Image Types

| Visibility | Description                                                               |
| ---------- | ------------------------------------------------------------------------- |
| `public`   | Provided by AceCloud, available to all users                              |
| `private`  | Created by you (via snapshot or save-image), visible only in your project |
| `shared`   | Shared with your project by another user                                  |

***

## Common Images

Some commonly used public images:

| Name               | OS            | Notes             |
| ------------------ | ------------- | ----------------- |
| `Ubuntu-22.04-LTS` | Ubuntu 22.04  | Long-term support |
| `Ubuntu-24.04-LTS` | Ubuntu 24.04  | Latest LTS        |
| `CentOS-9-Stream`  | CentOS 9      | Stream release    |
| `Debian-12`        | Debian 12     | Bookworm          |
| `Rocky-Linux-9`    | Rocky Linux 9 | RHEL-compatible   |

Image availability varies by region. Use `ace image list` to see what is available in your current region.

***

## Command Reference

| Command                               | Description               |
| ------------------------------------- | ------------------------- |
| `ace image list`                      | List all images           |
| `ace image list --os <os>`            | Filter images by OS       |
| `ace image list --category <cat>`     | Filter images by category |
| `ace image get <name-or-id>`          | Get image details         |
| `ace image delete <name-or-id> [...]` | Delete one or more images |
| `ace image categories`                | List image categories     |