2018-08-30 08:41:19 +00:00
% podman-pod-rm(1)
2018-07-09 17:04:29 +00:00
## NAME
podman\-pod\-rm - Remove one or more pods
## SYNOPSIS
2018-07-09 21:48:20 +00:00
**podman pod rm** [*options*] *pod*
2018-07-09 17:04:29 +00:00
## DESCRIPTION
2018-07-09 21:48:20 +00:00
**podman pod rm** will remove one or more pods 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. Without the \-f option, a pod cannot be removed if it has associated containers.
2018-07-09 17:04:29 +00:00
## OPTIONS
2019-03-31 08:51:46 +00:00
**--all, -a**
2018-07-09 17:04:29 +00:00
2018-07-09 21:48:20 +00:00
Remove all pods. Can be used in conjunction with \-f as well.
2018-07-09 17:04:29 +00:00
2018-07-09 21:48:20 +00:00
**--latest, -l**
2018-07-09 17:04:29 +00:00
2018-07-19 18:58:48 +00:00
Instead of providing the pod name or ID, remove the last created pod.
2018-07-09 21:48:20 +00:00
2019-02-21 23:09:59 +00:00
The latest option is not supported on the remote client.
2019-03-31 08:51:46 +00:00
**--force, -f**
2018-07-09 21:48:20 +00:00
Stop running containers and delete all stopped containers before removal of pod.
2018-07-09 17:04:29 +00:00
## EXAMPLE
podman pod rm mywebserverpod
podman pod rm mywebserverpod myflaskserverpod 860a4b23
podman pod rm -f 860a4b23
podman pod rm -f -a
podman pod rm -fa
## SEE ALSO
podman-pod(1)
## HISTORY
2018-07-09 21:48:20 +00:00
July 2018, Originally compiled by Peter Hunt < pehunt @ redhat . com >