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       podman pod rm mywebserverpod
64
65
66
67       Remove multiple pods with given names and/or IDs
68
69       podman pod rm mywebserverpod myflaskserverpod 860a4b23
70
71
72
73       Forcefully remove pod with a given ID
74
75       podman pod rm -f 860a4b23
76
77
78
79       Forcefully remove all pods
80
81       podman pod rm -f -a
82       podman pod rm -fa
83
84
85
86       Remove pod using ID specified in a given file
87
88       podman pod rm --pod-id-file /path/to/id/file
89
90
91

Exit Status

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

SEE ALSO

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

HISTORY

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