NAME

       podman-pod-rm - Remove one or more stopped pods and containers

SYNOPSIS

       podman pod rm [options] pod

DESCRIPTION

       podman  pod  rm  removes one or more stopped pods and their containers from the host.  The
       pod name or ID can be used. The -f option stops  all  containers  and  then  removes  them
       before  removing  the pod. If all containers added by the user are in an exited state, the
       pod is removed.

OPTIONS

   --all, -a
       Remove all pods.  Can be used in conjunction with -f as well.

   --force, -f
       Stop running containers and delete all stopped containers before removal of pod.

   --ignore, -i
       Ignore errors when specified pods are not in the  container  store.   A  user  might  have
       decided to manually remove a pod which leads to a failure during the ExecStop directive of
       a systemd service referencing that pod.

   --latest, -l
       Instead of providing the pod name or ID, use the last created pod.  Note: the last started
       pod  can be from other users of Podman on the host machine.  (This option is not available
       with the remote Podman client, including Mac and Windows (excluding WSL2) machines)

   --pod-id-file=file
       Read pod ID from the specified file and rm the pod. Can be specified multiple times.

       If specified, the pod-id-file is removed along with the pod.

   --time, -t=seconds
       Seconds to wait before forcibly stopping running containers within the pod.   Use  -1  for
       infinite wait.

       The --force option must be specified to use the --time option.

EXAMPLE

       Remove pod with a given name

       podman pod rm mywebserverpod

       Remove multiple pods with given names and/or IDs

       podman pod rm mywebserverpod myflaskserverpod 860a4b23

       Forcefully remove pod with a given ID

       podman pod rm -f 860a4b23

       Forcefully remove all pods

       podman pod rm -f -a
       podman pod rm -fa

       Remove pod using ID specified in a given file

       podman pod rm --pod-id-file /path/to/id/file

Exit Status

       0   All specified pods removed

       1   One of the specified pods did not exist, and no other failures

       2   One of the specified pods is attached to a container

       125 The command fails for any other reason

SEE ALSO

       podman(1), podman-pod(1)

HISTORY

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

                                                                                 podman-pod-rm(1)