1podman-pod-rm(1) General Commands Manual podman-pod-rm(1)
2
3
4
6 podman-pod-rm - Remove one or more stopped pods and containers
7
8
10 podman pod rm [options] pod
11
12
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
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=file
45 Read pod ID from the specified file and rm the pod. Can be specified
46 multiple times.
47
48
49 --time, -t=seconds
50 Seconds to wait before forcibly stopping running containers within the
51 pod.
52
53
54 The --force option must be specified to use the --time option.
55
56
58 Remove pod with a given name
59
60
61 podman pod rm mywebserverpod
62
63
64
65 Remove multiple pods with given names and/or IDs
66
67
68 podman pod rm mywebserverpod myflaskserverpod 860a4b23
69
70
71
72 Forcefully remove pod with a given ID
73
74
75 podman pod rm -f 860a4b23
76
77
78
79 Forcefully remove all pods
80
81
82 podman pod rm -f -a
83 podman pod rm -fa
84
85
86
87 Remove pod using ID specified in a given file
88
89
90 podman pod rm --pod-id-file /path/to/id/file
91
92
93
95 0 All specified pods removed
96
97
98 1 One of the specified pods did not exist, and no other failures
99
100
101 2 One of the specified pods is attached to a container
102
103
104 125 The command fails for any other reason
105
106
108 podman(1), podman-pod(1)
109
110
112 July 2018, Originally compiled by Peter Hunt pehunt@redhat.com
113 ⟨mailto:pehunt@redhat.com⟩
114
115
116
117 podman-pod-rm(1)