buildah-containers(1)

💖 buildah-containers(1) 💖

okay bestie, listen up — this is the manual page for buildah-containers, part of the buildah fam. it lives in the General Commands Manual section, and honestly? it's giving "let me just show you what's in my closet" energy. we're gonna get you fluent, no cap.

---

✨ NAME ✨

buildah-containers — list the working containers and their base images. that's it. that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

buildah containers [options]

---

✨ DESCRIPTION ✨

okay so this one is SO straightforward and i love that for it. it lists containers which appear to be Buildah working containers, along with their names and IDs, and then — the bestie part — it also shows you the names and IDs of the images from which they were initialized. so you get the container AND its origin story. main character and backstory, periodt. 🦋

---

✨ OPTIONS ✨

• --all, -a — list info about all containers, even the ones that were not created by Buildah and aren't being used by Buildah. how do you tell them apart? containers created by Buildah get an '*' in the 'BUILDER' column. cute lil star, iykyk ⭐
• --filter, -f — filter the output based on conditions you provide. yes queen, narrow it down. 🎀

here are the valid filters, pls memorize:

• id — [ID] Container's ID
• name — [Name] Container's name
• ancestor — [ImageName] Image or descendant used to create container

• --format — pretty-print containers using a Go template. so you can make it look exactly how you want it to look, obsessed. 🌸

valid placeholders for the Go template are listed below:

• .ContainerID — Container ID
• .Builder — Whether container was created by buildah
• .ImageID — Image ID
• .ImageName — Image name
• .ContainerName — Container name

• --json — output in JSON format. for the data girlies. 🔥
• --noheading, -n — omit the table headings from the listing of containers. bye bye headers 👋
• --notruncate — do not truncate IDs and image names in the output. no more lil ... cutting your faves off mid-name, we hate to see it. 😭
• --quiet, -q — displays only the container IDs. minimal. clean. iconic. 💅

---

✨ EXAMPLE ✨

okay bestie here's where it gets fun, watch:

buildah containers

CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
ccf84de04b80     *     53ce4390f2ad registry.access.redhat.com/ub... ubi8-working-container
45be1d806fc5     *     16ea53ea7c65 docker.io/library/busybox:latest busybox-working-container

see those lil stars in the BUILDER column? yeah. buildah babies. 🫶

now let's go quiet mode:

buildah containers --quiet

ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

and stacking flags like the pro you are:

buildah containers -q --noheading --notruncate

ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

json girlies rise up:

buildah containers --json

[
    {
        "id": "ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8",
        "builder": true,
        "imageid": "53ce4390f2adb1681eb1a90ec8b48c49c015e0a8d336c197637e7f65e365fa9e",
        "imagename": "registry.access.redhat.com/ubi8:latest",
        "containername": "ubi8-working-container"
    },
    {
        "id": "45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07",
        "builder": true,
        "imageid": "16ea53ea7c652456803632d67517b78a4f9075a10bfdc4fc6b7b4cbf2bc98497",
        "imagename": "docker.io/library/busybox:latest",
        "containername": "busybox-working-container"
    }
]

templates!! make it yours 💖

buildah containers --format "{{.ContainerID}} {{.ContainerName}}"

ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8   ubi8-working-container
45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07   busybox-working-container

and if you want a lil label on it:

buildah containers --format "Container ID: {{.ContainerID}}"

Container   ID:   ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
Container   ID:   45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

now filter by ancestor, chef's kiss:

buildah containers --filter ancestor=ubuntu

CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
fbfd3505376e     *     0ff04b2e7b63 docker.io/library/ubuntu:latest  ubuntu-working-container

---

✨ SEE ALSO ✨

• buildah(1) — go read the parent page too, it's the whole ecosystem bestie 🌈

---

and that's the tea, bestie. this page comes from the buildah manual, dated March 2017 🎀 — yes she's been serving since 2017 and she has not missed a day. go list those containers, you got this. 💜✨