1podman-pause(1)             General Commands Manual            podman-pause(1)
2
3
4

NAME

6       podman-pause - Pause one or more containers
7
8

SYNOPSIS

10       podman pause [options] [container...]
11
12
13       podman container pause [options] [container...]
14
15

DESCRIPTION

17       Pauses  all  the processes in one or more containers.  You may use con‐
18       tainer IDs or names as input.
19
20

OPTIONS

22   --all, -a
23       Pause all running containers.
24
25
26   --cidfile=file
27       Read container ID from the specified file and pause the container.  Can
28       be specified multiple times.
29
30
31   --filter, -f=filter
32       Filter  what containers pause.  Multiple filters can be given with mul‐
33       tiple uses of the --filter flag.  Filters with the same key work inclu‐
34       sive  with  the  only exception being label which is exclusive. Filters
35       with different keys always work exclusive.
36
37
38       Valid filters are listed below:
39
40
41       ┌─────────┬───────────────────────────────┐
42       │Filter   │ Description                   │
43       ├─────────┼───────────────────────────────┤
44       │id       │ [ID] Container's ID  (accepts │
45       │         │ regex)                        │
46       ├─────────┼───────────────────────────────┤
47       │name     │ [Name]  Container's name (ac‐ │
48       │         │ cepts regex)                  │
49       ├─────────┼───────────────────────────────┤
50       │label    │ [Key]  or  [Key=Value]  Label │
51       │         │ assigned to a container       │
52       ├─────────┼───────────────────────────────┤
53       │exited   │ [Int] Container's exit code   │
54       ├─────────┼───────────────────────────────┤
55       │status   │ [Status]  Container's status: │
56       │         │ 'created',          'exited', │
57       │         │ 'paused',   'running',   'un‐ │
58       │         │ known'                        │
59       ├─────────┼───────────────────────────────┤
60       │ancestor │ [ImageName] Image or  descen‐ │
61       │         │ dant used to create container │
62       ├─────────┼───────────────────────────────┤
63       │before   │ [ID]   or  [Name]  Containers │
64       │         │ created before this container │
65       ├─────────┼───────────────────────────────┤
66       │since    │ [ID]  or  [Name]   Containers │
67       │         │ created since this container  │
68       ├─────────┼───────────────────────────────┤
69       │volume   │ [VolumeName]  or [Mountpoint‐ │
70       │         │ Destination]  Volume  mounted │
71       │         │ in container                  │
72       ├─────────┼───────────────────────────────┤
73       │health   │ [Status] healthy or unhealthy │
74       ├─────────┼───────────────────────────────┤
75       │pod      │ [Pod] name or full or partial │
76       │         │ ID of pod                     │
77       ├─────────┼───────────────────────────────┤
78       │network  │ [Network] name or full ID  of │
79       │         │ network                       │
80       └─────────┴───────────────────────────────┘
81
82   --latest, -l
83       Instead  of  providing  the  container name or ID, use the last created
84       container. If you use methods other than Podman to run containers  such
85       as  CRI-O,  the  last  started  container could be from either of those
86       methods. (This option is not available with the remote  Podman  client,
87       including Mac and Windows (excluding WSL2) machines)
88
89

EXAMPLE

91       Pause container named 'mywebserver'
92
93
94              podman pause mywebserver
95
96
97
98       Pause container by partial container ID.
99
100
101              podman pause 860a4b23
102
103
104
105       Pause all running containers.
106
107
108              podman pause --all
109
110
111
112       Pause container using ID specified in a given files.
113
114
115              podman pause --cidfile /home/user/cidfile-1
116              podman pause --cidfile /home/user/cidfile-1 --cidfile ./cidfile-2
117
118
119
120       Pause the latest container created by Podman.
121
122
123              podman pause --latest
124
125
126

SEE ALSO

128       podman(1), podman-unpause(1)
129
130

HISTORY

132       September  2017,  Originally  compiled  by  Dan Walsh dwalsh@redhat.com
133       ⟨mailto:dwalsh@redhat.com⟩
134
135
136
137                                                               podman-pause(1)