Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
podman-pod-rm(1)	     General Commands Manual		podman-pod-rm(1)

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 contain-
     ers 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 multi-
     ple 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:pe-
     hunt@redhat.com>

								podman-pod-rm(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-pod-rm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help