aboutsummaryrefslogtreecommitdiff
path: root/docs/source/man/podman-restart.1.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/man/podman-restart.1.md')
-rw-r--r--docs/source/man/podman-restart.1.md68
1 files changed, 68 insertions, 0 deletions
diff --git a/docs/source/man/podman-restart.1.md b/docs/source/man/podman-restart.1.md
new file mode 100644
index 000000000..08fa29244
--- /dev/null
+++ b/docs/source/man/podman-restart.1.md
@@ -0,0 +1,68 @@
+% podman-restart(1)
+
+## NAME
+podman\-restart - Restart one or more containers
+
+## SYNOPSIS
+**podman restart** [*options*] *container* ...
+
+**podman container restart** [*options*] *container* ...
+
+## DESCRIPTION
+The restart command allows containers to be restarted using their ID or name.
+Containers will be stopped if they are running and then restarted. Stopped
+containers will not be stopped and will only be started.
+
+## OPTIONS
+**--all**, **-a**
+Restart all containers regardless of their current state.
+
+**--latest**, **-l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
+
+The latest option is not supported on the remote client.
+
+**--running**
+Restart all containers that are already in the *running* state.
+
+**--timeout**=*time*
+Timeout to wait before forcibly stopping the container.
+
+
+## EXAMPLES ##
+
+Restart the latest container
+```
+$ podman restart -l
+ec588fc80b05e19d3006bf2e8aa325f0a2e2ff1f609b7afb39176ca8e3e13467
+```
+
+Restart a specific container by partial container ID
+```
+$ podman restart ff6cf1
+ff6cf1e5e77e6dba1efc7f3fcdb20e8b89ad8947bc0518be1fcb2c78681f226f
+```
+
+Restart two containers by name with a timeout of 4 seconds
+```
+$ podman restart --timeout 4 test1 test2
+c3bb026838c30e5097f079fa365c9a4769d52e1017588278fa00d5c68ebc1502
+17e13a63081a995136f907024bcfe50ff532917988a152da229db9d894c5a9ec
+```
+
+Restart all running containers
+```
+$ podman restart --running
+```
+
+Restart all containers
+```
+$ podman restart --all
+```
+
+## SEE ALSO
+podman(1), podman-run(1), podman-start(1), podman-create(1)
+
+## HISTORY
+March 2018, Originally compiled by Matt Heon <mheon@redhat.com>