podman-pod-rm(1)

1podman-pod-rm(1)()                                          podman-pod-rm(1)()
2
3
4

NAME

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

SYNOPSIS

10       podman pod rm [options] pod
11
12

DESCRIPTION

14       podman pod rm will remove one or more stopped pods and their containers
15       from the host.  The pod name or ID can be used. The -f option stops all
16       containers  and  then removes them before removing the pod. If all con‐
17       tainers added by the user are in an exited state, the pod will  be  re‐
18       moved.
19
20

OPTIONS

22   --all, -a
23       Remove all pods.  Can be used in conjunction with -f as well.
24
25
26   --ignore, -i
27       Ignore  errors  when  specified pods are not in the container store.  A
28       user might have decided to manually remove a pod which would lead to  a
29       failure  during the ExecStop directive of a systemd service referencing
30       that pod.
31
32
33   --latest, -l
34       Instead of providing the pod name or ID, remove the last  created  pod.
35       (This option is not available with the remote Podman client)
36
37
38   --force, -f
39       Stop  running  containers  and delete all stopped containers before re‐
40       moval of pod.
41
42
43   --pod-id-file
44       Read pod ID from the specified file and remove the pod.  Can be  speci‐
45       fied multiple times.
46
47

EXAMPLE

49       podman pod rm mywebserverpod
50
51
52       podman pod rm mywebserverpod myflaskserverpod 860a4b23
53
54
55       podman pod rm -f 860a4b23
56
57
58       podman pod rm -f -a
59
60
61       podman pod rm -fa
62
63
64       podman pod rm --pod-id-file /path/to/id/file
65
66

Exit Status

68       0   All specified pods removed
69
70
71       1   One of the specified pods did not exist, and no other failures
72
73
74       2   One of the specified pods is attached to a container
75
76
77       125 The command fails for any other reason
78
79

HISTORY

85       July   2018,   Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
86       ⟨mailto:pehunt@redhat.com⟩
87
88
89
90                                                            podman-pod-rm(1)()