buildah-images(1)

💖 buildah-images 💖

okay bestie, listen up — this is buildah-images, living in the General Commands Manual section, and it's literally the command you run when you wanna see what images are chillin' in your local storage. no cap. 🎀

---

✨ NAME ✨

buildah-images — list images in local storage. that's it, that's the whole job, and she does it flawlessly. 👑

---

🌸 SYNOPSIS 🌸

buildah images [options] [image]

---

🦋 DESCRIPTION 🦋

So here's the tea: this bad boy displays all your locally stored images, showing off their names, sizes, created date and their IDs. main character energy fr fr. 💅

And the created date? It's displayed in the time locale of the local machine — so it speaks your machine's language, not some random timezone's. iykyk. 🕐✨

---

🌈 OPTIONS 🌈

• --all, -a — show all the images, including the intermediate images that came from a build. the hidden lore. 🫶
• --digests — show the image digests. receipts, basically. 🧾
• --filter, -f=[] — filter the output based on conditions provided (default is []). now let's get into which filters, because there are a lot and they all slay:
  • 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 image is considered to be dangling if it has no associated names and tags. it's giving orphan era. 😭
  • id=id — show the image with this specific ID.
  • intermediate=true|false — show intermediate images. an image is considered to be an intermediate image if it is dangling and has no children. (yes, the original says "indermediate" — we keep the typo energy, we just don't repeat it, bestie 💀)
  • label=key[=value] — filter by image labels, by 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, and every single one of them is iconic in her own way:
  • .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. the plot of the whole saga. 📜
• --json — display the output in JSON format. for the machine besties. 🤖
• --no-trunc — do not truncate output. show me everything, no edits, no cuts. 🔥
• --noheading, -n — omit the table headings from the listing of images. minimalism, we love her. 🎀
• --quiet, -q — displays only the image IDs. just the essentials, no small talk. 💜

---

🌟 EXAMPLE 🌟

here's a lil buffet of things you can literally type right now:

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}}"

and here's what actually comes out, verbatim, so you know what you're getting into:

$ 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 👀

go read these next, bestie, they're the whole friend group:

• buildah(1)
• containers-storage.conf(5)

---

🌈 that's the whole page! no details were harmed in the making of this rewrite — every flag, every filter, every placeholder, every example, exactly where it belongs. 🫶

okay that's a wrap, bestie!! this lil page comes to you from buildah, dated March 2017, and it's filed under buildah-images(1) — go list some images, you absolute icon 💅✨💖