Files
podman/docs/source/markdown/podman-pod-start.1.md.in
Ed Santiago 74388fe75f Man pages: refactor common options: --pod-id-file
Much like --cidfile (#15414), --pod-id-file has two meanings.
One is used in pod-related commands, one in container ones.
Both meanings read the file, so the read/write split used
in --cidfile is not applicable here.

podman-pod-create keeps its --pod-id-file option because
that one cannot be refactored: that's the only command (now)
that writes a pod-id file.

Reviewable using hack/markdown-preprocess-review but I
did take some liberties with the #### args because they
were wrong. And, since I had to much with the description
text anyway (resulting in diffs), I also took the liberty
of cleaning up a double space.

Signed-off-by: Ed Santiago <santiago@redhat.com>
2022-08-22 18:37:38 -06:00

57 lines
1.1 KiB
Markdown

% podman-pod-start(1)
## NAME
podman\-pod\-start - Start one or more pods
## SYNOPSIS
**podman pod start** [*options*] *pod* ...
## DESCRIPTION
Start containers in one or more pods. You may use pod IDs or names as input. The pod must have a container attached
to be started.
## OPTIONS
#### **--all**, **-a**
Starts all pods
#### **--latest**, **-l**
Instead of providing the pod name or ID, start the last created pod. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
@@option pod-id-file.pod
## EXAMPLE
Start pod with a given name
```
podman pod start mywebserverpod
```
Start pods with given IDs
```
podman pod start 860a4b23 5421ab4
```
Start the latest pod created by Podman
```
podman pod start --latest
```
Start all pods
```
podman pod start --all
```
Start pod using ID specified in a given file
```
podman pod start --pod-id-file /path/to/id/file
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-pod(1)](podman-pod.1.md)**, **[podman-pod-stop(1)](podman-pod-stop.1.md)**
## HISTORY
July 2018, Adapted from podman start man page by Peter Hunt <pehunt@redhat.com>