docker-container-pause(1)

docker-container-pause1

Pause all processes within one or more containers

Usage

docker container pause CONTAINER [CONTAINER ...]

Overview

The docker container pause command suspends all processes in the specified containers. On Linux, this uses the freezer cgroup. Traditionally, when suspending a process the SIGSTOP signal is used, which is observable by the process being suspended. With the freezer cgroup the process is unaware, and unable to capture, that it is being suspended, and subsequently resumed. On Windows, only Hyper-V containers can be paused.

See the freezer cgroup documentation ⟨https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt⟩ for further details.

docker-container-unpause(1) to unpause all processes within a container.

Releases

5 releases since Debian 10 (Buster); the text changed 4 times.

  1. 10
  2. 11
  3. 12
  4. 13
  5. Arch

From docker 1:29.9.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.