podman-wait(1) General Commands Manual podman-wait(1)
NAME
podman-wait - Wait on one or more containers to stop and print their
exit codes
SYNOPSIS
podman wait [options] container [...]
podman container wait [options] container [...]
DESCRIPTION
Waits on one or more containers to stop. The container can be referred
to by its name or ID. In the case of multiple containers, Podman waits
on each consecutively. After all conditions are satisfied, the contain-
ers' return codes are printed separated by newline in the same order as
they were given to the command. An exit code of -1 is emitted for all
conditions other than "stopped" and "exited".
When waiting for containers with a restart policy of always or on-fail-
ure, such as those created by podman kube play, the containers may be
repeatedly exiting and restarting, possibly with different exit codes.
podman wait will only display and detect the first exit after the wait
command was started.
When running a container with podman run --rm wait does not wait for the
container to be fully removed. To wait for the removal of a container
use --condition=removing.
OPTIONS
--condition=state
Container state or condition to wait for. Can be specified multiple
times where at least one condition must match for the command to return.
Supported values are "configured", "created", "exited", "healthy", "ini-
tialized", "paused", "removing", "running", "stopped", "stopping", "un-
healthy". The default condition is "stopped".
--help, -h
Print usage statement
--ignore
Ignore errors when a specified container is missing and mark its return
code as -1.
--interval, -i=duration
Time interval to wait before polling for completion. A duration string
is a sequence of decimal numbers, each with optional fraction and a unit
suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns",
"us" (or "µs"), "ms", "s", "m", "h". Time unit defaults to "ms".
--latest, -l
Instead of providing the container name or ID, use the last created con-
tainer. Note: the last started container can be from other users of
Podman on the host machine. (This option is not available with the re-
mote Podman client, including Mac and Windows (excluding WSL2) machines)
EXAMPLES
Wait for the specified container to exit.
$ podman wait mywebserver
0
Wait for the latest container to exit. (This option is not available
with the remote Podman client, including Mac and Windows (excluding
WSL2) machines)
$ podman wait --latest
0
Wait for the container to exit, checking every two seconds.
$ podman wait --interval 2s mywebserver
0
Wait for the container by ID. This container exits with error status 1:
$ podman wait 860a4b23
1
Wait for both specified containers to exit.
$ podman wait mywebserver myftpserver
0
125
Wait for the named container to exit, but do not fail if the container
does not exist.
$ podman wait --ignore does-not-exist
-1
SEE ALSO
podman(1)
HISTORY
September 2017, Originally compiled by Brent Baudebbaude@redhat.com
⟨mailto:bbaude@redhat.com⟩
podman-wait(1)
Generated by dwww version 1.16 on Sat Dec 6 05:49:56 CET 2025.