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
34
35       The latest option is not supported on the remote client.
36
37
38   --force, -f
39       Stop running  containers  and  delete  all  stopped  containers  before
40       removal of pod.
41
42
43   --pod-id-file
44       Read  pod ID from the specified file and remove the pod.  Can be speci‐
45       fied multiple times.
46
47

EXAMPLE

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

Exit Status

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

HISTORY

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