diff --git a/docs/reference/commandline/create.md b/docs/reference/commandline/create.md
index fd7db14e6f..74d5185a34 100644
--- a/docs/reference/commandline/create.md
+++ b/docs/reference/commandline/create.md
@@ -59,7 +59,7 @@ Creates a new container.
--pid="" PID namespace to use
--privileged=false Give extended privileges to this container
--read-only=false Mount the container's root filesystem as read only
- --restart="no" Restart policy (no, on-failure[:max-retry], always)
+ --restart="no" Restart policy (no, on-failure[:max-retry], always, unless-stopped)
--security-opt=[] Security options
-t, --tty=false Allocate a pseudo-TTY
--disable-content-trust=true Skip image verification
diff --git a/docs/reference/commandline/run.md b/docs/reference/commandline/run.md
index e563ab6382..6ee97906d9 100644
--- a/docs/reference/commandline/run.md
+++ b/docs/reference/commandline/run.md
@@ -59,7 +59,7 @@ weight=1
--pid="" PID namespace to use
--privileged=false Give extended privileges to this container
--read-only=false Mount the container's root filesystem as read only
- --restart="no" Restart policy (no, on-failure[:max-retry], always)
+ --restart="no" Restart policy (no, on-failure[:max-retry], always, unless-stopped)
--rm=false Automatically remove the container when it exits
--security-opt=[] Security Options
--sig-proxy=true Proxy received signals to the process
@@ -441,7 +441,16 @@ Docker supports the following restart policies:
Always restart the container regardless of the exit status.
When you specify always, the Docker daemon will try to restart
- the container indefinitely.
+ the container indefinitely. The container will also always start
+ on daemon startup, regardless of the current state of the container.
+ |
+
+
+ unless-stopped |
+
+ Always restart the container regardless of the exit status, but
+ do not start it on daemon startup if the container has been put
+ to a stopped state before.
|
diff --git a/docs/reference/run.md b/docs/reference/run.md
index 036918901d..1dfef0c70f 100644
--- a/docs/reference/run.md
+++ b/docs/reference/run.md
@@ -402,7 +402,16 @@ Docker supports the following restart policies:
Always restart the container regardless of the exit status.
When you specify always, the Docker daemon will try to restart
- the container indefinitely.
+ the container indefinitely. The container will also always start
+ on daemon startup, regardless of the current state of the container.
+ |
+
+
+ unless-stopped |
+
+ Always restart the container regardless of the exit status, but
+ do not start it on daemon startup if the container has been put
+ to a stopped state before.
|
diff --git a/man/docker-create.1.md b/man/docker-create.1.md
index 06965332dd..13ea642441 100644
--- a/man/docker-create.1.md
+++ b/man/docker-create.1.md
@@ -234,7 +234,7 @@ This value should always larger than **-m**, so you should always use this with
Mount the container's root filesystem as read only.
**--restart**="no"
- Restart policy to apply when a container exits (no, on-failure[:max-retry], always)
+ Restart policy to apply when a container exits (no, on-failure[:max-retry], always, unless-stopped).
**--security-opt**=[]
Security Options
diff --git a/man/docker-run.1.md b/man/docker-run.1.md
index b49c9b69d6..7fb9d0f162 100644
--- a/man/docker-run.1.md
+++ b/man/docker-run.1.md
@@ -370,7 +370,7 @@ to write files anywhere. By specifying the `--read-only` flag the container wil
its root filesystem mounted as read only prohibiting any writes.
**--restart**="no"
- Restart policy to apply when a container exits (no, on-failure[:max-retry], always)
+ Restart policy to apply when a container exits (no, on-failure[:max-retry], always, unless-stopped).
**--rm**=*true*|*false*
Automatically remove the container when it exits (incompatible with -d). The default is *false*.