# protect image

1 min read

* * *

Copy Markdown for LLMs

Manage the images.

```bash
protect image <COMMAND>
```

Commands:

- [`pull`](https://docs.edera.dev/reference/cli/v0.0.1/image/#pull) Pull an image into the cache.
- [`import`](https://docs.edera.dev/reference/cli/v0.0.1/image/#import) Import an image into the cache.
- [`remove`](https://docs.edera.dev/reference/cli/v0.0.1/image/#remove) Remove an image from the cache.
- [`list`](https://docs.edera.dev/reference/cli/v0.0.1/image/#list) List cached images.

## pull [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/image/#pull)

Pull an image into the cache.

```bash
protect image pull [OPTIONS] <IMAGE>
```

Arguments:

- `<IMAGE>` Image name

Options:

- `-s, --image-format <IMAGE_FORMAT>` Image format \[default: squashfs\] \[possible values: squashfs, erofs, tar, directory\].
- `-n, --no-update` Don’t update from registry.
- `-o, --overwrite-cache` Overwrite image cache.

## import [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/image/#import)

Import an image into the cache.

```text
protect image import [OPTIONS] --digest <DIGEST> --image <IMAGE>
```

Options:

- `-d, --digest <DIGEST>` Image digest.
- `-n, --image <IMAGE>` Image name.
- `-s, --image-format <IMAGE_FORMAT>` Image format \[default: squashfs\] \[possible values: squashfs, erofs, tar, directory\].
- `-o, --overwrite-cache` Overwrite image cache.
- `-i <INPUT_FILE>` Input image tar \[default: /dev/stdin\].

## remove [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/image/#remove)

Remove an image from the cache.

```text
protect image remove [OPTIONS] <DIGEST>
```

Arguments:

- `<DIGEST>` Image digest

Options:

- `-s, --image-format <IMAGE_FORMAT>` Image format \[default: squashfs\] \[possible values: squashfs, erofs, tar, directory\].

## list [Permalink for this section](https://docs.edera.dev/reference/cli/v0.0.1/image/#list)

List cached images.

```text
protect image list [OPTIONS]
```

Options:

- `-o, --output <OUTPUT>` Output format \[default: table\] \[possible values: table, json, json-pretty, jsonl, yaml, key-value, simple\].