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 (CID pre‐ │
45       │         │ fix match by default; accepts │
46       │         │ regex)                        │
47       ├─────────┼───────────────────────────────┤
48       │name     │ [Name] Container's name  (ac‐ │
49       │         │ cepts regex)                  │
50       ├─────────┼───────────────────────────────┤
51       │label    │ [Key]  or  [Key=Value]  Label │
52       │         │ assigned to a container       │
53       ├─────────┼───────────────────────────────┤
54       │exited   │ [Int] Container's exit code   │
55       ├─────────┼───────────────────────────────┤
56       │status   │ [Status] Container's  status: │
57       │         │ 'created',          'exited', │
58       │         │ 'paused',   'running',   'un‐ │
59       │         │ known'                        │
60       ├─────────┼───────────────────────────────┤
61       │ancestor │ [ImageName]  Image or descen‐ │
62       │         │ dant used to create container │
63       ├─────────┼───────────────────────────────┤
64       │before   │ [ID]  or  [Name]   Containers │
65       │         │ created before this container │
66       ├─────────┼───────────────────────────────┤
67       │since    │ [ID]   or  [Name]  Containers │
68       │         │ created since this container  │
69       ├─────────┼───────────────────────────────┤
70       │volume   │ [VolumeName] or  [Mountpoint‐ │
71       │         │ Destination]  Volume  mounted │
72       │         │ in container                  │
73       ├─────────┼───────────────────────────────┤
74       │health   │ [Status] healthy or unhealthy │
75       ├─────────┼───────────────────────────────┤
76       │pod      │ [Pod] name or full or partial │
77       │         │ ID of pod                     │
78       ├─────────┼───────────────────────────────┤
79       │network  │ [Network]  name or full ID of │
80       │         │ network                       │
81       ├─────────┼───────────────────────────────┤
82       │until    │ [DateTime] container  created │
83       │         │ before  the given duration or │
84       │         │ time.                         │
85       └─────────┴───────────────────────────────┘
86
87   --latest, -l
88       Instead of providing the container name or ID,  use  the  last  created
89       container.  Note: the last started container can be from other users of
90       Podman on the host machine.  (This option is not available with the re‐
91       mote  Podman  client,  including  Mac  and Windows (excluding WSL2) ma‐
92       chines)
93
94

EXAMPLE

96       Pause container named 'mywebserver'
97
98       podman pause mywebserver
99
100
101
102       Pause container by partial container ID.
103
104       podman pause 860a4b23
105
106
107
108       Pause all running containers.
109
110       podman pause --all
111
112
113
114       Pause container using ID specified in a given files.
115
116       podman pause --cidfile /home/user/cidfile-1
117       podman pause --cidfile /home/user/cidfile-1 --cidfile ./cidfile-2
118
119
120
121       Pause the latest container created by Podman.
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)