---
name: "buildah-images"
section: "1"
platform: "linux"
package: "buildah"
version: "1:1.45.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/buildah-images"
---

# buildah-images(1)

List images in local storage.

## NAME

buildah-images - List images in local storage.

## SYNOPSIS

**buildah images** \[*options*\] \[*image*\]

## DESCRIPTION

Displays locally stored images, their names, sizes, created date and their IDs. The created date is displayed in the time locale of the local machine.

## OPTIONS

**--all**, **-a**

Show all images, including intermediate images from a build.

**--digests**

Show the image digests.

**--filter**, **-f**=\[\]

Filter output based on conditions provided (default \[\]).

Filters:

**after,since=image**\
     Filter on images created since the given image.

**before=image**\
     Filter on images created before the given image.

**dangling=true\|false**\
     Show dangling images. An images is considered to be dangling if it has no associated names and tags.

**id=id**\
     Show image with this specific ID.

**intermediate=true\|false**\
     Show intermediate images. An images is considered to be an indermediate image if it is dangling and has no children.

**label=key\[=value\]**\
     Filter by images labels key and/or value.

**readonly=true\|false**\
     Show only read only images or Read/Write images. The default is to show both.  Read/Only images can be configured by modifying the  "additionalimagestores" in the /etc/containers/storage.conf file.

**reference=reference**\
     Show images matching the specified reference. Wildcards are supported (e.g., "reference=*fedora:3*").

**--format**="TEMPLATE"

Pretty-print images using a Go template.

Valid placeholders for the Go template are listed below:

| | |
| --- | --- |
| **Placeholder** | **Description** |
| .Created | Creation date in epoch time |
| .CreatedAt | Creation date Pretty Formatted |
| .CreatedAtRaw | Creation date in raw format |
| .Digest | Image Digest |
| .ID | Image ID |
| .Name | Image Name |
| .ReadOnly | Indicates if image came from a R/O store |
| .Size | Image Size |
| .Tag | Image Tag |

**--history**

Display the image name history.

**--json**

Display the output in JSON format.

**--no-trunc**

Do not truncate output.

**--noheading**, **-n**

Omit the table headings from the listing of images.

**--quiet**, **-q**

Displays only the image IDs.

## EXAMPLE

buildah images

buildah images fedora:latest

buildah images --json

buildah images --quiet

buildah images -q --noheading --no-trunc

buildah images --quiet fedora:latest

buildah images --filter dangling=true

buildah images --format "ImageID: {{.ID}}"

```
$ buildah images
REPOSITORY                        TAG        IMAGE ID       CREATED        SIZE
registry.access.redhat.com/ubi8   latest     53ce4390f2ad   3 weeks ago    233 MB
docker.io/library/busybox         latest     16ea53ea7c65   3 weeks ago    1.46 MB
quay.io/libpod/testimage          20210610   9f9ec7f2fdef   4 months ago   7.99 MB
```

```
# buildah images -a
IMAGE NAME                                               IMAGE TAG            IMAGE ID             CREATED AT             SIZE
registry.access.redhat.com/ubi8   latest     53ce4390f2ad   3 weeks ago    233 MB
<none>                                                   <none>               8c6e16890c2b         Jun 13, 2018 15:52     4.42 MB
localhost/test                                           latest               c0cfe75da054         Jun 13, 2018 15:52     4.42 MB
```

```
# buildah images --format '{{.ID}} {{.CreatedAtRaw}}'
3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 2018-12-20 19:21:30.122610396 -0500 EST
8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 2019-01-08 09:22:52.330623532 -0500 EST
```

```
# buildah images --format '{{.ID}} {{.Name}} {{.Digest}} {{.CreatedAt}} {{.Size}} {{.CreatedAtRaw}}'
3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 docker.io/library/alpine sha256:3d2e482b82608d153a374df3357c0291589a61cc194ec4a9ca2381073a17f58e Dec 20, 2018 19:21 4.67 MB 2018-12-20 19:21:30.122610396 -0500 EST
8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 <none> sha256:894532ec56e0205ce68ca7230b00c18aa3c8ee39fcdb310615c60e813057229c Jan 8, 2019 09:22 4.67 MB 2019-01-08 09:22:52.330623532 -0500 EST
```

## SEE ALSO

[buildah(1)](/buildah/1.md), [containers-storage.conf(5)](/containers-storage.conf/5.md)