| # pause | |
| <!---MARKER_GEN_START--> | |
| Pause all processes within one or more containers | |
| ### Aliases | |
| `docker container pause`, `docker pause` | |
| <!---MARKER_GEN_END--> | |
| ## 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](https://www.kernel.org/doc/Documentation/cgroup-v1/freezer-subsystem.txt) | |
| for further details. | |
| ## Examples | |
| ```console | |
| $ docker pause my_container | |
| ``` | |
| ## Related commands | |
| * [unpause](unpause.md) |