docker pause
Estimated reading time: 1 minuteEdge only: This is the CLI reference for Docker CE Edge versions. Some of these options may not be available to Docker CE stable or Docker EE. You can view the stable version of this CLI reference or learn about Docker CE Edge.
Description
Pause all processes within one or more containers
Usage
docker pause CONTAINER [CONTAINER...]
Parent command
| Command | Description |
|---|---|
| docker | The base command for the Docker CLI. |
Extended description
The docker pause command suspends all processes in the specified containers.
On Linux, this uses the cgroups freezer. Traditionally, when suspending a process
the SIGSTOP signal is used, which is observable by the process being suspended.
With the cgroups freezer 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 cgroups freezer documentation for further details.
Examples
$ docker pause my_container