docker-container-stop

docker container stop [options] container [container...]

docker container stop stops one or more running containers. It sends `SIGTERM` (or the signal specified by `--signal` / the container's `STOPSIGNAL`) to the main process inside the container. If the process does not exit within the timeout (default 10 seconds on Linux, 30 on Windows unless configured with `--stop-timeout` at create/run time), `SIGKILL` is sent.This is the preferred way to stop containers cleanly. The alias `docker stop` is equivalent.

-t, --timeout seconds

Seconds to wait for the container to stop after sending the stop signal before forcibly killing it with `SIGKILL`. Set to `-1` to wait indefinitely. Default: daemon default (10s Linux / 30s Windows) or the container's configured stop timeout.

Signal to send to the container (e.g. `SIGTERM`, `SIGINT`, `SIGKILL`, or a number). Default is the container's configured stop signal or `SIGTERM`.

If the main process ignores SIGTERM, the container may not stop until the timeout triggers SIGKILL. Stopped containers remain on disk and can be restarted with `docker start` / `docker container start`, or removed with `docker rm`.

docker-stop(1), docker-start(1), docker-container-start(1), docker-rm(1), docker-ps(1)

Documentation