buildah-containers(1)

NAME
buildah-containers - List the working containers and their base images.

SYNOPSIS
buildah containers [options]

DESCRIPTION
Lists containers which appear to be Buildah working containers, their names and IDs, and the names and IDs of the images from which they were initialized.

OPTIONS
--all, -a

List information about all containers, including those which were not created by and are not being used by Buildah. Containers created by Buildah are denoted with an '*' in the 'BUILDER' column.

--filter, -f

Filter output based on conditions provided.

Valid filters are listed below:

Filter | Description
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.

Valid placeholders for the Go template are listed below:

Placeholder | Description
.ContainerID | Container ID
.Builder | Whether container was created by buildah
.ImageID | Image ID
.ImageName | Image name
.ContainerName | Container name

--json

Output in JSON format.

--noheading, -n

Omit the table headings from the listing of containers.

--notruncate

Do not truncate IDs and image names in the output.

--quiet, -q

Displays only the container IDs.

EXAMPLE
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

buildah containers --quiet

    ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
    45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

buildah containers -q --noheading --notruncate

    ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
    45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

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

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

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

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

    Container   ID:   ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
    Container   ID:   45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

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)