moby--moby/docs/reference/commandline/stop.md

---
title: "stop"
description: "The stop command description and usage"
keywords: ["stop, SIGKILL, SIGTERM"]
---

# stop

```markdown
Usage:  docker stop [OPTIONS] CONTAINER [CONTAINER...]

Stop one or more running containers

Options:
      --help       Print usage
  -t, --time int   Seconds to wait for stop before killing it (default 10)
```

The main process inside the container will receive `SIGTERM`, and after a grace
period, `SIGKILL`.
Convert Markdown frontmatter to YAML Some frontmatter such as the weights, menu stuff, etc is no longer used 'draft=true' becomes 'published: false' Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2016-10-14 15:30:36 -07:00			`---`
			`title: "stop"`
			`description: "The stop command description and usage"`
			`keywords: ["stop, SIGKILL, SIGTERM"]`
			`---`
Splitting out the cli command into parts. Signed-off-by: Mary Anthony <mary@docker.com> 2015-06-21 13:41:38 -07:00
			`# stop`

Updates on cli reference documentation - Update ps with `--last` flag - Update commands with current output - Make sure hugo does not detect the wrong language - Update usage for `tag` command to be more coherent with the other ones Signed-off-by: Vincent Demeester <vincent@sbr.pm> 2016-07-07 20:43:18 +02:00			```markdown
			`Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...]`
Splitting out the cli command into parts. Signed-off-by: Mary Anthony <mary@docker.com> 2015-06-21 13:41:38 -07:00
Updates on cli reference documentation - Update ps with `--last` flag - Update commands with current output - Make sure hugo does not detect the wrong language - Update usage for `tag` command to be more coherent with the other ones Signed-off-by: Vincent Demeester <vincent@sbr.pm> 2016-07-07 20:43:18 +02:00			`Stop one or more running containers`
Splitting out the cli command into parts. Signed-off-by: Mary Anthony <mary@docker.com> 2015-06-21 13:41:38 -07:00
Updates on cli reference documentation - Update ps with `--last` flag - Update commands with current output - Make sure hugo does not detect the wrong language - Update usage for `tag` command to be more coherent with the other ones Signed-off-by: Vincent Demeester <vincent@sbr.pm> 2016-07-07 20:43:18 +02:00			`Options:`
			`--help Print usage`
			`-t, --time int Seconds to wait for stop before killing it (default 10)`
			```
Splitting out the cli command into parts. Signed-off-by: Mary Anthony <mary@docker.com> 2015-06-21 13:41:38 -07:00
			The main process inside the container will receive `SIGTERM`, and after a grace
Fix man and commandline docs - missing help option in `docs/reference/commandline/*.md` (some files have it, the other I fixed didn't) - missing `[OPTIONS]` in Usage description - missing options - formatting - start/stop idempotence Signed-off-by: Antonio Murdaca <amurdaca@redhat.com> 2015-10-03 17:56:41 +02:00			period, `SIGKILL`.