podman-pod-ps(1)

📦

version 6.1.4 · 8 versions

6.1.4 · arch rolling, centos-stream 10, nixpkgs unstable (latest)
3.4.4 · ubuntu jammy
5.6.2 · fedora 43, opensuse-leap 16.0
5.8.9 · alpine 3.24, centos-stream 9, fedora 43, fedora 44, nixos 26.05, ubuntu stonking
4.9.3 · ubuntu noble
4.3.1 · debian bookworm
5.7.0 · ubuntu resolute
5.4.2 · debian trixie, ubuntu questing

, in arch rolling, centos-stream 10, nixpkgs unstable

🦋 podman-pod-ps(1) 🦋

okay bestie, welcome to podman-pod-ps(1) from the General Commands Manual — this is the page about printing out info about pods, and we're gonna make it make sense. periodt. 💅

💖 NAME 💖

podman-pod-ps — Print out information about pods ✨

🎀 SYNOPSIS 🎀

podman pod ps [options]

🌸 DESCRIPTION 🌸

podman pod ps lists all pods on the system. By default it lists:

pod ID
pod name
the time the pod was created
number of containers attached to pod
container ID of the pod infra container
status of pod as defined by the following table (we're doing it as a bullet list, but the tea is identical 🍵)

Here's the status rundown, no cap:

Created — No containers running nor stopped
Running — at least one container is running
Stopped — At least one container stopped and none running
Exited — All containers stopped in pod
Dead — Error retrieving state

✨ OPTIONS ✨

--ctr-ids — Display the container IDs
--ctr-names — Display the container names
--ctr-status — Display the container statuses
--filter, -f=filter — Provide filter values.

If there is more than one filter, the --filter option should be passed multiple times: --filter label=test --filter until=10m.

Supported filters:

ctr-ids — Filter by container ID within the pod. (CID prefix match by default; accepts regex)
ctr-names — Filter by container name within the pod.
ctr-number — Filter by number of containers in the pod.
ctr-status — Filter by container status within the pod.
id — Filter by pod ID. (Prefix match by default; accepts regex)
label — Filter by container with (or without, in the case of label!=[...] is used) the specified labels.
name — Filter by pod name.
network — Filter by network name or full ID of network.
status — Filter by pod status.
until — Filter by pods created before given timestamp.

The ctr-ids, ctr-names, id, name filters accept regex format.

The ctr-status filter accepts values: created, running, paused, stopped, exited, unknown.

The label filter accepts two formats. One is the label=key or label=key=value, which removes containers with the specified labels. The other format is the label!=key or label!=key=value, which removes containers without the specified labels.

The until filter can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the machine's time.

The status filter accepts values: stopped, running, paused, exited, dead, created, degraded.

--format=format — Pretty-print containers to JSON or using a Go template

Valid placeholders for the Go template are listed below:

.Cgroup — Cgroup path of pod
.ContainerIds — Comma-separated list of container IDs in the pod
.ContainerNames — Comma-separated list of container names in the pod
.ContainerStatuses — Comma-separated list of container statuses
.Created — Creation time of pod
.ID — Container ID
.InfraID — Pod infra container ID
.Label string — Specified label of the pod
.Labels — All the labels assigned to the pod
.Name — Name of pod
.Networks — Show all networks connected to the infra container
.NumberOfContainers — Show the number of containers attached to pod
.Restarts — Show the total number of container restarts in a pod
.Status — Status of pod

--help, -h — Print usage statement
--latest, -l — Show the latest pod 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 of the pod
--no-trunc — Do not truncate the output (default false).
--noheading, -n — Omit the table headings from the listing.
--quiet, -q — Print the numeric IDs of the pods only
--sort — Sort by created, ID, name, status, or number of containers

Default: created

✨ EXAMPLES ✨

okay bestie, this is the fun part — receipts. every single example is right here, commands and output exactly as the page says, no edits, no cap. 💅

List all pods. the classic starter pack — no flags, just the whole pod roster:

$ podman pod ps
POD ID         NAME              STATUS    CREATED          INFRA ID       # OF CONTAINERS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   1
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   2

List all pods along with container names within the pods. now we're peeking inside the pods too:

$ podman pod ps --ctr-names
POD ID         NAME              STATUS    CREATED          INFRA ID       NAMES
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   loving_archimedes
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   thirsty_hawking,wizardly_golick

List all pods along with status, names and ids. full main-character energy — status, names, and ids all up in the mix:

$ podman pod ps --ctr-status --ctr-names --ctr-ids
POD ID         NAME              STATUS    CREATED          INFRA ID       IDS                         NAMES                             STATUS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   ba465ab0a3a4                loving_archimedes                 running
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   331693bff40a,8e428daeb89e   thirsty_hawking,wizardly_golick   configured,configured

List all pods and print ID, Container Names, and cgroups. custom --format moment — you pick the columns, you run the world:

$ podman pod ps --format "{{.ID}}  {{.ContainerNames}}  {{.Cgroup}}"
00dfd6fa02c0   loving_archimedes   /libpod_parent
f4df8692e116   thirsty_hawking,wizardly_golick   /libpod_parent

List all pods with two containers sorted by pod ID. filter + sort combo, lowkey iconic:

$ podman pod ps --sort id --filter ctr-number=2
POD ID         NAME             STATUS    CREATED          INFRA ID       # OF CONTAINERS
f4df8692e116   nifty_torvalds   Created   10 minutes ago   331693bff40a   2

List all pods with their container ids. the --ctr-ids serve:

$ podman pod ps  --ctr-ids
POD ID         NAME              STATUS    CREATED          INFRA ID       IDS
00dfd6fa02c0   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4   ba465ab0a3a4
f4df8692e116   nifty_torvalds    Created   10 minutes ago   331693bff40a   331693bff40a,8e428daeb89e

List all pods with container ids without truncating IDs. no shortening, no hiding — full ids only:

$ podman pod ps --no-trunc --ctr-ids
POD ID                                                             NAME              STATUS    CREATED          INFRA ID                                                           IDS
00dfd6fa02c0a2daaedfdf8fcecd06f22ad114d46d167d71777224735f701866   jolly_goldstine   Running   31 hours ago     ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050   ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050
f4df8692e116a3e6d1d62572644ed36ca475d933808cc3c93435c45aa139314b   nifty_torvalds    Created   10 minutes ago   331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0   331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0,8e428daeb89e69b71e7916a13accfb87d122889442b5c05c2d99cf94a3230e9d

List all pods with container names. this one has a whole little friend group in the NAMES column:

$ podman pod ps --ctr-names
POD ID         NAME   STATUS    CREATED        INFRA ID       NAMES
314f4da82d74   hi     Created   17 hours ago   a9f2d2165675   jovial_jackson,hopeful_archimedes,vibrant_ptolemy,heuristic_jennings,keen_raman,hopeful_newton,mystifying_bose,silly_lalande,serene_lichterman ...

List pods containing the specified container ID. hunting down one specific container id like it's a crush's finsta:

$ podman pod ps --filter ctr-ids=aceb3b775797
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
952330c7cff0  web-app     Running     3 minutes ago  b0f247c49669  3

List all pods with exactly 2 containers. not one, not three — exactly two, periodt:

$ podman pod ps --filter ctr-number=2
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     2 minutes ago  fda2a486b939  2

List pods with containers in exited status. catching the ones that already left the chat:

$ podman pod ps --filter ctr-status=exited
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
06c3a107763a  maintenance  Degraded    4 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    4 minutes ago  d6650a490b69  3

Filter pod by ID. when you know the exact id and you're not settling:

$ podman pod ps --filter id=95938982244d
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
95938982244d  nettest     Running     4 minutes ago  a28d133e8c63  3

Filter pod by label. label girlies rise:

$ podman pod ps --filter label=tier=frontend
POD ID        NAME         STATUS      CREATED       INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     1 second ago  fda2a486b939  2

Filter pod by name. name-based search, cute and direct:

$ podman pod ps --filter name=db-cluster
POD ID        NAME        STATUS      CREATED        INFRA ID      # OF CONTAINERS
1e3424d7e9c0  db-cluster  Degraded    4 minutes ago  d6650a490b69  3

Filter pod by pod status (e.g., Degraded). the degraded filter, doing its dramatic little thing:

$ podman pod ps --filter status=degraded
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
95938982244d  nettest      Degraded    7 minutes ago  a28d133e8c63  3
06c3a107763a  maintenance  Degraded    8 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    8 minutes ago  d6650a490b69  3
952330c7cff0  web-app      Degraded    8 minutes ago  b0f247c49669  3

Filter pods created before a time threshold (--until). time-travel-ish filtering, but make it 2m:

$ podman pod ps --filter until=2m
POD ID        NAME         STATUS      CREATED        INFRA ID      # OF CONTAINERS
b2ae050d17be  labeled-pod  Running     3 minutes ago  fda2a486b939  2
95938982244d  nettest      Degraded    8 minutes ago  a28d133e8c63  3
deee8956522e  utility      Running     8 minutes ago  6b730e3ac334  3
06c3a107763a  maintenance  Degraded    8 minutes ago  67e500cbb678  3
1e3424d7e9c0  db-cluster   Degraded    8 minutes ago  d6650a490b69  3
952330c7cff0  web-app      Degraded    8 minutes ago  b0f247c49669  3

🎀 pod ps

Print a list of pods. that's the whole assignment, bestie — print the pods, collect the clout. 💅

👀 SEE ALSO

podman(1), podman-pod(1)

📜 HISTORY

July 2018, Originally compiled by Peter Hunt pehunt@redhat.com ⟨mailto:pehunt@redhat.com⟩

and that's the page, bestie — footer says podman-pod-ps(1), history is stamped July 2018, and we are officially done. mwah 💋✨

📦 where this page comes from

arch rolling: podman 6.1.4-1 · Apache-2.0
centos-stream 10: podman 7:6.1.0-2.el10 · Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND ISC AND MIT AND MPL-2.0
nixpkgs unstable: podman 6.1.4
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms