podman-ps - Man Page

Print out information about containers

Examples (TL;DR)

List currently running Podman containers: podman ps
List all Podman containers (running and stopped): podman ps --all
Show the latest created container (includes all states): podman ps --latest
Filter containers that contain a substring in their name: podman ps --filter "name=name"
Filter containers that share a given image as an ancestor: podman ps --filter "ancestor=image:tag"
Filter containers by exit status code: podman ps --all --filter "exited=code"
Filter containers by status (created, running, removing, paused, exited and dead): podman ps --filter "status=status"
Filter containers that mount a specific volume or have a volume mounted in a specific path: podman ps --filter "volume=path/to/directory" --format "table .ID\t.Image\t.Names\t.Mounts"

tldr.sh

Synopsis

podman ps [options]

podman container ps [options]

podman container list [options]

podman container ls [options]

Description

podman ps lists the running containers on the system. Use the --all flag to view all the containers information. By default it lists:

container id
the name of the image the container is using
the COMMAND the container is executing
the time the container was created
the status of the container
port mappings the container is using
alternative names for the container

Options

--all, -a

Show all the containers, default is only running containers.

Note: Podman shares containers storage with other tools such as Buildah and CRI-O. In some cases these external containers might also exist in the same storage. Use the --external option to see these external containers. External containers show the 'storage' status.

--external

Display external containers that are not controlled by Podman but are stored in containers storage. These external containers are generally created via other container technology such as Buildah or CRI-O and may depend on the same container images that Podman is also using. External containers are denoted with either a 'buildah' or 'storage' in the COMMAND and STATUS column of the ps output.

--filter, -f

Filter what containers are shown in the output. Multiple filters can be given with multiple uses of the --filter flag. Filters with the same key work inclusive with the only exception being label which is exclusive. Filters with different keys always work exclusive.

Valid filters are listed below:

Filter	Description
id	[ID] Container's ID (CID prefix match by default; accepts regex)
name	[Name] Container's name (accepts regex)
label	[Key] or [Key=Value] Label assigned to a container
label!	[Key] or [Key=Value] Label NOT assigned to a container
exited	[Int] Container's exit code
status	[Status] Container's status: 'created', 'exited', 'paused', 'running', 'unknown'
ancestor	[ImageName] Image or descendant used to create container (accepts regex)
before	[ID] or [Name] Containers created before this container
since	[ID] or [Name] Containers created since this container
volume	[VolumeName] or [MountpointDestination] Volume mounted in container
health	[Status] healthy or unhealthy
pod	[Pod] name or full or partial ID of pod
network	[Network] name or full ID of network
until	[DateTime] container created before the given duration or time.

--format=format

Pretty-print containers to JSON or using a Go template

Valid placeholders for the Go template are listed below:

Placeholder	Description
.AutoRemove	If true, containers are removed on exit
.CIDFile	Container ID File
.Command	Quoted command used
.Created ...	Creation time for container, Y-M-D H:M:S
.CreatedAt	Creation time for container (same as above)
.CreatedHuman	Creation time, relative
.ExitCode	Container exit code
.Exited	"true" if container has exited
.ExitedAt	Time (epoch seconds) that container exited
.ID	Container ID
.Image	Image Name/ID
.ImageID	Image ID
.IsInfra	"true" if infra container
.Label string	Specified label of the container
.Labels ...	All the labels assigned to the container
.Mounts	Volumes mounted in the container
.Names	Name of container
.Networks	Show all networks connected to the container
.Pid	Process ID on host system
.Pod	Pod the container is associated with (SHA)
.PodName	PodName of the container
.Ports	Exposed ports
.Restarts	Display the container restart count
.RunningFor	Time elapsed since container was started
.Size	Size of container
.StartedAt	Time (epoch seconds) the container started
.State	Human-friendly description of ctr state
.Status	Status of container

--help, -h

Print usage statement

--last, -n

Print the n last created containers (all states)

--latest, -l

Show the latest container created (all states) (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)

--namespace, --ns

Display namespace information

--no-trunc

Do not truncate the output (default false).

--noheading

Omit the table headings from the listing of containers.

--pod, -p

Display the pods the containers are associated with

--quiet, -q

Print the numeric IDs of the containers only

--size, -s

Display the total file size

--sort=created

Sort by command, created, id, image, names, runningfor, size, or status", Note: Choosing size sorts by size of rootFs, not alphabetically like the rest of the options

--sync

Force a sync of container state with the OCI runtime. In some cases, a container's state in the runtime can become out of sync with Podman's state. This updates Podman's state based on what the OCI runtime reports. Forcibly syncing is much slower, but can resolve inconsistent state issues.

--watch, -w

Refresh the output with current containers on an interval in seconds.

Examples

List running containers.

$ podman ps
CONTAINER ID  IMAGE                            COMMAND    CREATED        STATUS        PORTS                                                   NAMES
4089df24d4f3  docker.io/library/centos:latest  /bin/bash  2 minutes ago  Up 2 minutes  0.0.0.0:80->8080/tcp, 0.0.0.0:2000-2006->2000-2006/tcp  manyports
92f58933c28c  docker.io/library/centos:latest  /bin/bash  3 minutes ago  Up 3 minutes  192.168.99.100:1000-1006->1000-1006/tcp                 zen_sanderson

List all containers.

$ podman ps -a
CONTAINER ID   IMAGE         COMMAND         CREATED       STATUS                    PORTS     NAMES
02f65160e14ca  redis:alpine  "redis-server"  19 hours ago  Exited (-1) 19 hours ago  6379/tcp  k8s_podsandbox1-redis_podsandbox1_redhat.test.crio_redhat-test-crio_0
69ed779d8ef9f  redis:alpine  "redis-server"  25 hours ago  Created                   6379/tcp  k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1

List all containers including their size. Note: this can take longer since Podman needs to calculate the size from the file system.

$ podman ps -a -s
CONTAINER ID   IMAGE         COMMAND         CREATED       STATUS                    PORTS     NAMES                                                                  SIZE
02f65160e14ca  redis:alpine  "redis-server"  20 hours ago  Exited (-1) 20 hours ago  6379/tcp  k8s_podsandbox1-redis_podsandbox1_redhat.test.crio_redhat-test-crio_0  27.49 MB
69ed779d8ef9f  redis:alpine  "redis-server"  25 hours ago  Created                   6379/tcp  k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1         27.49 MB

List all containers, running or not, using a custom Go format.

$ podman ps -a --format "{{.ID}}  {{.Image}}  {{.Labels}}  {{.Mounts}}"
02f65160e14ca  redis:alpine  tier=backend  proc,tmpfs,devpts,shm,mqueue,sysfs,cgroup,/var/run/,/var/run/
69ed779d8ef9f  redis:alpine  batch=no,type=small  proc,tmpfs,devpts,shm,mqueue,sysfs,cgroup,/var/run/,/var/run/

List all containers and display their namespaces.

$ podman ps --ns -a
CONTAINER ID    NAMES                                                                   PID     CGROUP       IPC          MNT          NET          PIDNS        USER         UTS
3557d882a82e3   k8s_container2_podsandbox1_redhat.test.crio_redhat-test-crio_1          29910   4026531835   4026532585   4026532593   4026532508   4026532595   4026531837   4026532594
09564cdae0bec   k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1          29851   4026531835   4026532585   4026532590   4026532508   4026532592   4026531837   4026532591
a31ebbee9cee7   k8s_podsandbox1-redis_podsandbox1_redhat.test.crio_redhat-test-crio_0   29717   4026531835   4026532585   4026532587   4026532508   4026532589   4026531837   4026532588

List all containers including size sorted by names.

$ podman ps -a --size --sort names
CONTAINER ID   IMAGE         COMMAND         CREATED       STATUS                    PORTS     NAMES
69ed779d8ef9f  redis:alpine  "redis-server"  25 hours ago  Created                   6379/tcp  k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1
02f65160e14ca  redis:alpine  "redis-server"  19 hours ago  Exited (-1) 19 hours ago  6379/tcp  k8s_podsandbox1-redis_podsandbox1_redhat.test.crio_redhat-test-crio_0

List all external containers created by tools other than Podman.

$ podman ps --external -a
CONTAINER ID  IMAGE                             COMMAND  CREATED      STATUS  PORTS  NAMES
69ed779d8ef9f  redis:alpine  "redis-server"  25 hours ago  Created                   6379/tcp  k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1
38a8a78596f9  docker.io/library/busybox:latest  buildah  2 hours ago  storage        busybox-working-container
fd7b786b5c32  docker.io/library/alpine:latest   buildah  2 hours ago  storage        alpine-working-container
f78620804e00  scratch                           buildah  2 hours ago  storage        working-container