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   --force, -f
27       Stop  running  containers  and delete all stopped containers before re‐
28       moval of pod.
29
30
31   --ignore, -i
32       Ignore errors when specified pods are not in the  container  store.   A
33       user  might have decided to manually remove a pod which would lead to a
34       failure during the ExecStop directive of a systemd service  referencing
35       that pod.
36
37
38   --latest, -l
39       Instead  of  providing the pod name or ID, remove the last created pod.
40       (This option is not available with the remote Podman client,  including
41       Mac and Windows (excluding WSL2) machines)
42
43
44   --pod-id-file
45       Read  pod ID from the specified file and remove the pod.  Can be speci‐
46       fied multiple times.
47
48
49   --time, -t=seconds
50       Seconds to wait before forcibly stopping running containers within  the
51       pod. The --force option must be specified to use the --time option.
52
53

EXAMPLE

55       Remove pod with a given name
56
57
58              podman pod rm mywebserverpod
59
60
61
62       Remove multiple pods with given names and/or IDs
63
64
65              podman pod rm mywebserverpod myflaskserverpod 860a4b23
66
67
68
69       Forcefully remove pod with a given ID
70
71
72              podman pod rm -f 860a4b23
73
74
75
76       Forcefully remove all pods
77
78
79              podman pod rm -f -a
80              podman pod rm -fa
81
82
83
84       Remove pod using ID specified in a given file
85
86
87              podman pod rm --pod-id-file /path/to/id/file
88
89
90

Exit Status

92       0   All specified pods removed
93
94
95       1   One of the specified pods did not exist, and no other failures
96
97
98       2   One of the specified pods is attached to a container
99
100
101       125 The command fails for any other reason
102
103

SEE ALSO

105       podman(1), podman-pod(1)
106
107

HISTORY

109       July   2018,   Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
110       ⟨mailto:pehunt@redhat.com⟩
111
112
113
114                                                            podman-pod-rm(1)()
Impressum