1podman-pod-stop(1)          General Commands Manual         podman-pod-stop(1)
2
3
4

NAME

6       podman-pod-stop - Stop one or more pods
7
8

SYNOPSIS

10       podman pod stop [options] pod ...
11
12

DESCRIPTION

14       Stop  containers  in one or more pods.  You may use pod IDs or names as
15       input.
16
17

OPTIONS

19   --all, -a
20       Stops all pods
21
22
23   --ignore, -i
24       Ignore errors when specified pods are not in the  container  store.   A
25       user might have decided to manually remove a pod which leads to a fail‐
26       ure during the ExecStop directive of a systemd service referencing that
27       pod.
28
29
30   --latest, -l
31       Instead  of  providing  the  pod  name or ID, use the last created pod.
32       Note: the last started pod can be from other users  of  Podman  on  the
33       host  machine.   (This  option  is not available with the remote Podman
34       client, including Mac and Windows (excluding WSL2) machines)
35
36
37   --pod-id-file=file
38       Read pod ID from the specified file and stop the pod. Can be  specified
39       multiple times.
40
41
42   --time, -t=seconds
43       Seconds  to wait before forcibly stopping running containers within the
44       pod.  Use -1 for infinite wait.
45
46

EXAMPLE

48       Stop pod with a given name
49
50
51              $ podman pod stop mywebserverpod
52              cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907
53
54
55
56       Stop multiple pods with given IDs.
57
58
59              $ podman pod stop 490eb 3557fb
60              490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
61              3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
62
63
64
65       Stop the last created pod
66
67
68              $ podman pod stop --latest
69              3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
70
71
72
73       Stop all pods
74
75
76              $ podman pod stop --all
77              19456b4cd557eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818
78              3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
79              490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
80              70c358daecf71ef9be8f62404f926080ca0133277ef7ce4f6aa2d5af6bb2d3e9
81              cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907
82
83
84
85       Stop two pods via --pod-id-file
86
87
88              $ podman pod stop --pod-id-file file1 --pod-id-file file2
89              19456b4cd557eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818
90              cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907
91
92
93
94       Stop all pods with a timeout of 1 second
95
96
97              $ podman pod stop -a -t 1
98              3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
99              490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
100              70c358daecf71ef9be8f62404f926080ca0133277ef7ce4f6aa2d5af6bb2d3e9
101
102
103

SEE ALSO

105       podman(1), podman-pod(1), podman-pod-start(1)
106
107

HISTORY

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