1podman-pod-rm(1)            General Commands Manual           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  removes  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 is removed.
18
19

OPTIONS

21   --all, -a
22       Remove all pods.  Can be used in conjunction with -f as well.
23
24
25   --force, -f
26       Stop running containers and delete all stopped  containers  before  re‐
27       moval of pod.
28
29
30   --ignore, -i
31       Ignore  errors  when  specified pods are not in the container store.  A
32       user might have decided to manually remove a pod which leads to a fail‐
33       ure during the ExecStop directive of a systemd service referencing that
34       pod.
35
36
37   --latest, -l
38       Instead of providing the pod name or ID,  use  the  last  created  pod.
39       Note:  the  last  started  pod can be from other users of Podman on the
40       host machine.  (This option is not available  with  the  remote  Podman
41       client, including 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       If specified, the pod-id-file is removed along with the pod.
50
51
52   --time, -t=seconds
53       Seconds to wait before forcibly stopping running containers within  the
54       pod.  Use -1 for infinite wait.
55
56
57       The --force option must be specified to use the --time option.
58
59

EXAMPLE

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

Exit Status

98       0   All specified pods removed
99
100
101       1   One of the specified pods did not exist, and no other failures
102
103
104       2   One of the specified pods is attached to a container
105
106
107       125 The command fails for any other reason
108
109

SEE ALSO

111       podman(1), podman-pod(1)
112
113

HISTORY

115       July   2018,   Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
116       ⟨mailto:pehunt@redhat.com⟩
117
118
119
120                                                              podman-pod-rm(1)
Impressum