podman-pod-rm(1)

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.
17
18

OPTIONS

20   --all, -a
21       Remove all pods.  Can be used in conjunction with -f as well.
22
23
24   --ignore, -i
25       Ignore  errors  when  specified pods are not in the container store.  A
26       user might have decided to manually remove a pod which would lead to  a
27       failure  during the ExecStop directive of a systemd service referencing
28       that pod.
29
30
31   --latest, -l
32       Instead of providing the pod name or ID, remove the last  created  pod.
33       (This option is not available with the remote Podman client)
34
35
36   --force, -f
37       Stop  running  containers  and delete all stopped containers before re‐
38       moval of pod.
39
40
41   --pod-id-file
42       Read pod ID from the specified file and remove the pod.  Can be  speci‐
43       fied multiple times.
44
45

EXAMPLE

47       podman pod rm mywebserverpod
48
49
50       podman pod rm mywebserverpod myflaskserverpod 860a4b23
51
52
53       podman pod rm -f 860a4b23
54
55
56       podman pod rm -f -a
57
58
59       podman pod rm -fa
60
61
62       podman pod rm --pod-id-file /path/to/id/file
63
64

Exit Status

66       0   All specified pods removed
67
68
69       1   One of the specified pods did not exist, and no other failures
70
71
72       2   One of the specified pods is attached to a container
73
74
75       125 The command fails for any other reason
76
77

HISTORY

83       July   2018,   Originally  compiled  by  Peter  Hunt  pehunt@redhat.com
84       ⟨mailto:pehunt@redhat.com⟩
85
86
87
88                                                            podman-pod-rm(1)()