docker kill
Estimated reading time: 1 minuteDescription
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.