podman-pause(1)

💖 podman-pause 💖

okay so listen bestie — this is the podman-pause page, from the General Commands Manual, and it is lowkey a whole vibe. It's giving "freeze frame" for your containers. let's get into it. 🫶

✨ NAME ✨

podman-pause — pause one or more containers 😌

✨ SYNOPSIS ✨

podman pause [options] [container...]

podman container pause [options] [container...]

✨ DESCRIPTION ✨

okay so what does it actually do? It pauses all the processes in one or more containers. that's the whole assignment. you can use container IDs or names as input — super chill, super flexible. slay. 💅

✨ OPTIONS ✨

• --all, -a — pause all running containers. every single one. no cap. 🔥
• --cidfile=file — reads the container ID from the file you specify, then pauses that container. can be specified multiple times if you're feeling extra. 📁
• --filter, -f=filter — filters what containers get paused. multiple filters? just use the --filter flag multiple times. here's the tea: filters with the same key work inclusive together — the only exception is label, which is exclusive. filters with different keys always work exclusive. iykyk. 🍵

valid filters are listed below (and yes bestie, I kept every single one):

• id — [ID] Container's ID (CID prefix match by default; accepts regex)
• name — [Name] Container's name (accepts regex)
• annotation — [Key] or [Key=Value] Annotation assigned to a container
• annotation! — [Key] or [Key=Value] Annotation NOT assigned to a container
• label — [Key] or [Key=Value] Label assigned to a container
• label! — [Key] or [Key=Value] Label NOT assigned to a container
• exited — [Int] Container's exit code
• status — [Status] Container's status: 'created', 'initialized', 'running', 'stopped', 'paused', 'exited', 'removing', 'stopping', 'unknown'
• ancestor — [ImageName] Image or descendant used to create container (accepts regex)
• before — [ID] or [Name] Containers created before this container
• since — [ID] or [Name] Containers created since this container
• volume — [VolumeName] or [MountpointDestination] 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
• restart-policy — [Policy] Container's restart policy (e.g., 'no', 'on-failure', 'always', 'unless-stopped')
• until — [DateTime] Containers created before the given duration or time.
• command — [Command] the command the container is executing, only argv[0] is taken
• should-start-on-boot — [Bool] Containers that need to be restarted after system reboot. True for containers with restart policy 'always', or 'unless-stopped' that were not explicitly stopped by the user
• --latest, -l — instead of giving a container name or ID, just use the last created container. iconic. Note: the last started container can be from other users of Podman on the host machine — so like, be aware. also heads up: this option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines. 💀

✨ EXAMPLE ✨

pause a specified container:

podman pause mywebserver

pause a container by partial container ID:

podman pause 860a4b23

pause all running containers:

podman pause --all

pause a container using the 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 remote Podman client, including Mac and Windows (excluding WSL2) machines):

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⟩

---

okay bestie that's the whole page — this has been podman-pause(1), General Commands Manual, September 2017 vintage, originally compiled by Dan Walsh. go forth and pause those containers fr fr, you're gonna slay 💖✨🎀🦋