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
83   --latest, -l
84       Instead of providing the container name or ID,  use  the  last  created
85       container.  Note: the last started container can be from other users of
86       Podman on the host machine.  (This option is not available with the re‐
87       mote  Podman  client,  including  Mac  and Windows (excluding WSL2) ma‐
88       chines)
89
90

EXAMPLE

92       Pause container named 'mywebserver'
93
94
95              podman pause mywebserver
96
97
98
99       Pause container by partial container ID.
100
101
102              podman pause 860a4b23
103
104
105
106       Pause all running containers.
107
108
109              podman pause --all
110
111
112
113       Pause container using ID specified in a given files.
114
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
124              podman pause --latest
125
126
127

SEE ALSO

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

HISTORY

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