command: docker kill
short: Kill one or more running containers
long: |-
  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**
  >
  > `ENTRYPOINT` and `CMD` in 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.
usage: docker kill [OPTIONS] CONTAINER [CONTAINER...]
pname: docker
plink: docker.yaml
options:
- option: signal
  shorthand: s
  value_type: string
  default_value: KILL
  description: Signal to send to the container
  deprecated: false
  experimental: false
  experimentalcli: false
  kubernetes: false
  swarm: false
examples: |-
  ### Send a KILL signal  to a container

  The following example sends the default `KILL` signal to the container named
  `my_container`:

  ```bash
  $ docker kill my_container
  ```

  ### Send a custom signal  to a container

  The following example sends a `SIGHUP` signal to the container named
  `my_container`:

  ```bash
  $ 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:

  ```bash
  $ docker kill --signal=SIGHUP my_container
  $ docker kill --signal=HUP my_container
  $ docker kill --signal=1 my_container
  ```

  Refer to the [`signal(7)`](http://man7.org/linux/man-pages/man7/signal.7.html)
  man-page for a list of standard Linux signals.
deprecated: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false

