Kill one or more running containers
$ docker kill [OPTIONS] CONTAINER [CONTAINER...]
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 reference a container by its
ID, ID-prefix, or name.
-s shorthand) flag sets the system call signal that is sent
to the container. This signal can be a signal name in the format
SIGINT, or an unsigned number that matches a position in the kernel’s
syscall table, for instance
While the default (
SIGKILL) signal will terminate the container, the signal
--signal may be non-terminal, depending on the container’s main
process. For example, the
SIGHUP signal in most cases will be non-terminal,
and the container will continue running after receiving the signal.
CMDin the shell form run as a child process 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.
For example uses of this command, refer to the examples section below.
||Signal to send to the container|
Send a KILL signal to a container
The following example sends the default
SIGKILL signal to the container named
$ docker kill my_container
Send a custom signal to a container
The following example sends a
SIGHUP signal to the container named
$ docker kill --signal=SIGHUP my_container
You can specify a custom signal either by name, or number. The
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
man-page for a list of standard Linux signals.