docker kill
Description
Kill one or more running containers
Usage
docker kill [OPTIONS] CONTAINER [CONTAINER...]
Options
| Name, shorthand | Default | Description |
--signal , -s | KILL | Signal to send to the container |
Parent command
| Command | Description |
|---|---|
| docker | The base command for the Docker CLI. |
Extended description
The docker kill subcommand kills one or more containers. The main process inside the container is sent SIGKILL signal (default), or the signal that is specified with the --signal option. You can kill a container using the container’s ID, ID-prefix, or name.
Note:
ENTRYPOINTandCMDin the shell form run as a subcommand of/bin/sh -c, which does not pass signals. This means that the executable is not the container’s PID 1 and does not receive Unix signals.
Examples
Send a KILL signal to a container
The following example sends the default KILL signal to the container named my_container:
$ docker kill my_container
Send a custom signal to a container
The following example sends a SIGHUP signal to the container named my_container:
$ docker kill --signal=SIGHUP my_container
You can specify a custom signal either by name, or number. The SIG prefix is optional, so the following examples are equivalent:
$ docker kill --signal=SIGHUP my_container
$ docker kill --signal=HUP my_container
$ docker kill --signal=1 my_container
Refer to the signal(7) man-page for a list of standard Linux signals.
© 2019 Docker, Inc.
Licensed under the Apache License, Version 2.0.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.
Docker, Inc. and other parties may also have trademark rights in other terms used herein.
https://docs.docker.com/engine/reference/commandline/kill/