DockerCLI/docs/reference/commandline/pause.md

title	description	keywords
pause	The pause command description and usage	cgroups, container, suspend, SIGSTOP

pause

Usage:  docker pause CONTAINER [CONTAINER...]

Pause all processes within one or more containers

Aliases:
  docker container pause, docker pause

Options:
      --help   Print usage

Description

The docker 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 for further details.

Examples

$ docker pause my_container

Related commands

• unpause