podman-pod-rm(1)

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 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=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

EXAMPLE

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

Exit Status

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

HISTORY

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