DOKK / manpages / debian 11 / podman / podman-pod-rm.1.en
podman-pod-rm(1)() podman-pod-rm(1)()

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

podman pod rm [options] pod

podman pod rm will remove 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.

--all, -a

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

--ignore, -i

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

--latest, -l

Instead of providing the pod name or ID, remove the last created pod.

The latest option is not supported on the remote client.

--force, -f

Stop running containers and delete all stopped containers before removal of pod.

--pod-id-file

Read pod ID from the specified file and remove the pod. Can be specified multiple times.

podman pod rm mywebserverpod

podman pod rm mywebserverpod myflaskserverpod 860a4b23

podman pod rm -f 860a4b23

podman pod rm -f -a

podman pod rm -fa

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

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

podman-pod(1)

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