'\" t
.nh
.TH buildah-containers "1" "March 2017" "buildah"
.SH NAME
.PP
buildah-containers - List the working containers and their base images.

.SH SYNOPSIS
.PP
\fBbuildah containers\fP [\fIoptions\fP]

.SH DESCRIPTION
.PP
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.

.SH OPTIONS
.PP
\fB--all\fP, \fB-a\fP

.PP
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.

.PP
\fB--filter\fP, \fB-f\fP

.PP
Filter output based on conditions provided.

.PP
Valid filters are listed below:

.TS
allbox;
l l 
l l .
\fB\fBFilter\fP\fP	\fB\fBDescription\fP\fP
id	[ID] Container's ID
name	[Name] Container's name
ancestor	T{
[ImageName] Image or descendant used to create container
T}
.TE

.PP
\fB--format\fP

.PP
Pretty-print containers using a Go template.

.PP
Valid placeholders for the Go template are listed below:

.TS
allbox;
l l 
l l .
\fB\fBPlaceholder\fP\fP	\fB\fBDescription\fP\fP
\&.ContainerID	Container ID
\&.Builder	T{
Whether container was created by buildah
T}
\&.ImageID	Image ID
\&.ImageName	Image name
\&.ContainerName	Container name
.TE

.PP
\fB--json\fP

.PP
Output in JSON format.

.PP
\fB--noheading\fP, \fB-n\fP

.PP
Omit the table headings from the listing of containers.

.PP
\fB--notruncate\fP

.PP
Do not truncate IDs and image names in the output.

.PP
\fB--quiet\fP, \fB-q\fP

.PP
Displays only the container IDs.

.SH EXAMPLE
.PP
buildah containers

.EX
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
.EE

.PP
buildah containers --quiet

.EX
ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07
.EE

.PP
buildah containers -q --noheading --notruncate

.EX
ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07
.EE

.PP
buildah containers --json

.EX
[
    {
        "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"
    }
]
.EE

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

.EX
ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8   ubi8-working-container
45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07   busybox-working-container
.EE

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

.EX
Container   ID:   ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
Container   ID:   45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07
.EE

.PP
buildah containers --filter ancestor=ubuntu

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

.SH SEE ALSO
.PP
buildah(1)