.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\fC\fBFilter\fP\fR	\fB\fC\fBDescription\fP\fR
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\fC\fBPlaceholder\fP\fR	\fB\fC\fBDescription\fP\fR
\&.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

.PP
.RS

.nf
CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
29bdb522fc62     *     3fd9065eaf02 docker.io/library/alpine:latest  alpine\-working\-container
c6b04237ac8e     *     f9b6f7f7b9d3 docker.io/library/busybox:latest busybox\-working\-container

.fi
.RE

.PP
buildah containers \-\-quiet

.PP
.RS

.nf
29bdb522fc62d43fca0c1a0f11cfc6dfcfed169cf6cf25f928ebca1a612ff5b0
c6b04237ac8e9d435ec9cf0e7eda91e302f2db9ef908418522c2d666352281eb

.fi
.RE

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

.PP
.RS

.nf
29bdb522fc62d43fca0c1a0f11cfc6dfcfed169cf6cf25f928ebca1a612ff5b0
c6b04237ac8e9d435ec9cf0e7eda91e302f2db9ef908418522c2d666352281eb

.fi
.RE

.PP
buildah containers \-\-json

.PP
.RS

.nf
[
    {
        "id": "29bdb522fc62d43fca0c1a0f11cfc6dfcfed169cf6cf25f928ebca1a612ff5b0",
        "builder": true,
        "imageid": "3fd9065eaf02feaf94d68376da52541925650b81698c53c6824d92ff63f98353",
        "imagename": "docker.io/library/alpine:latest",
        "containername": "alpine\-working\-container"
    },
    {
        "id": "c6b04237ac8e9d435ec9cf0e7eda91e302f2db9ef908418522c2d666352281eb",
        "builder": true,
        "imageid": "f9b6f7f7b9d34113f66e16a9da3e921a580937aec98da344b852ca540aaa2242",
        "imagename": "docker.io/library/busybox:latest",
        "containername": "busybox\-working\-container"
    }
]

.fi
.RE

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

.PP
.RS

.nf
3fbeaa87e583ee7a3e6787b2d3af961ef21946a0c01a08938e4f52d53cce4c04 myalpine\-working\-container
fbfd3505376ee639c3ed50f9d32b78445cd59198a1dfcacf2e7958cda2516d5c ubuntu\-working\-container

.fi
.RE

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

.PP
.RS

.nf
Container ID: 3fbeaa87e583ee7a3e6787b2d3af961ef21946a0c01a08938e4f52d53cce4c04
Container ID: fbfd3505376ee639c3ed50f9d32b78445cd59198a1dfcacf2e7958cda2516d5c

.fi
.RE

.PP
buildah containers \-\-filter ancestor=ubuntu

.PP
.RS

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

.fi
.RE

.SH SEE ALSO
.PP
buildah(1)