podman-pause(1) General Commands Manual podman-pause(1)
NAME
podman-pause - Pause one or more containers
SYNOPSIS
podman pause [options] [container...]
podman container pause [options] [container...]
DESCRIPTION
Pauses all the processes in one or more containers. You may use con-
tainer IDs or names as input.
OPTIONS
--all, -a
Pause all running containers.
--cidfile=file
Read container ID from the specified file and pause the container. Can
be specified multiple times.
--filter, -f=filter
Filter what containers pause. Multiple filters can be given with multi-
ple uses of the --filter flag. Filters with the same key work inclusive
with the only exception being label which is exclusive. Filters with
different keys always work exclusive.
Valid filters are listed below:
┌──────────┬───────────────────────────────┐
│ Filter │ Description │
├──────────┼───────────────────────────────┤
│ id │ [ID] Container's ID (CID pre- │
│ │ fix match by default; accepts │
│ │ regex) │
├──────────┼───────────────────────────────┤
│ name │ [Name] Container's name (ac- │
│ │ cepts regex) │
├──────────┼───────────────────────────────┤
│ label │ [Key] or [Key=Value] Label │
│ │ assigned to a container │
├──────────┼───────────────────────────────┤
│ exited │ [Int] Container's exit code │
├──────────┼───────────────────────────────┤
│ status │ [Status] Container's status: │
│ │ 'created', 'initialized', │
│ │ 'exited', 'paused', 'run- │
│ │ ning', 'unknown' │
├──────────┼───────────────────────────────┤
│ ancestor │ [ImageName] Image or descen- │
│ │ dant used to create container │
├──────────┼───────────────────────────────┤
│ before │ [ID] or [Name] Containers │
│ │ created before this container │
├──────────┼───────────────────────────────┤
│ since │ [ID] or [Name] Containers │
│ │ created since this container │
├──────────┼───────────────────────────────┤
│ volume │ [VolumeName] or [Mountpoint- │
│ │ Destination] Volume mounted │
│ │ in container │
├──────────┼───────────────────────────────┤
│ health │ [Status] healthy or unhealthy │
├──────────┼───────────────────────────────┤
│ pod │ [Pod] name or full or partial │
│ │ ID of pod │
├──────────┼───────────────────────────────┤
│ network │ [Network] name or full ID of │
│ │ network │
├──────────┼───────────────────────────────┤
│ until │ [DateTime] Containers created │
│ │ before the given duration or │
│ │ time. │
└──────────┴───────────────────────────────┘
--latest, -l
Instead of providing the container name or ID, use the last created con-
tainer. Note: the last started container can be from other users of
Podman on the host machine. (This option is not available with the re-
mote Podman client, including Mac and Windows (excluding WSL2) machines)
EXAMPLE
Pause specified container:
podman pause mywebserver
Pause container by partial container ID:
podman pause 860a4b23
Pause all running containers:
podman pause --all
Pause container using ID specified in given files:
podman pause --cidfile /home/user/cidfile-1
podman pause --cidfile /home/user/cidfile-1 --cidfile ./cidfile-2
Pause the latest container. (This option is not available with the re-
mote Podman client, including Mac and Windows (excluding WSL2) ma-
chines):
podman pause --latest
SEE ALSO
podman(1), podman-unpause(1)
HISTORY
September 2017, Originally compiled by Dan Walsh dwalsh@redhat.com
⟨mailto:dwalsh@redhat.com⟩
podman-pause(1)
Generated by dwww version 1.16 on Tue Dec 16 06:00:34 CET 2025.