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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acecloud.ai/knowledge-base/cli/compute/images.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.