-
Notifications
You must be signed in to change notification settings - Fork 2.6k
/
Copy pathpodman-start.1.md.in
90 lines (65 loc) · 3.55 KB
/
podman-start.1.md.in
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
% podman-start 1
## NAME
podman\-start - Start one or more containers
## SYNOPSIS
**podman start** [*options*] *container* ...
**podman container start** [*options*] *container* ...
## DESCRIPTION
Start one or more containers using container IDs or names as input. The *attach* and *interactive*
options cannot be used to override the *--tty* and *--interactive* options from when the container
was created. Starting an already running container with the *--attach* option, Podman simply
attaches to the container.
## OPTIONS
#### **--all**
Start all the containers, default is only running containers.
#### **--attach**, **-a**
Attach container's STDOUT and STDERR. The default is false. This option cannot be used when
starting multiple containers.
@@option detach-keys
#### **--filter**, **-f**
Filter what containers are going to be started from the given arguments.
Multiple filters can be given with multiple uses of the --filter flag.
Filters with the same key work inclusive with the only exception being
`label` which is exclusive. Filters with different keys always work exclusive.
Valid filters are listed below:
| **Filter** | **Description** |
|------------|-------------------------------------------------------------------------------------------------|
| id | [ID] Container's ID (CID prefix match by default; accepts regex) |
| name | [Name] Container's name (accepts regex) |
| label | [Key] or [Key=Value] Label assigned to a container |
| exited | [Int] Container's exit code |
| status | [Status] Container's status: 'created', 'initialized', 'exited', 'paused', 'running', 'unknown' |
| ancestor | [ImageName] Image or descendant used to create container |
| before | [ID] or [Name] Containers created before this container |
| since | [ID] or [Name] Containers created since this container |
| volume | [VolumeName] or [MountpointDestination] Volume mounted in container |
| health | [Status] healthy or unhealthy |
| pod | [Pod] name or full or partial ID of pod |
| network | [Network] name or full ID of network |
| until | [DateTime] Containers created before the given duration or time. |
| command | [Command] the command the container is executing, only argv[0] is taken |
@@option interactive
@@option latest
@@option sig-proxy
The default is **true** when attaching, **false** otherwise.
## EXAMPLE
Start specified container:
```
podman start mywebserver
```
Start multiple containers:
```
podman start 860a4b231279 5421ab43b45
```
Start specified container in interactive mode with terminal attached:
```
podman start --interactive --attach 860a4b231279
```
Start last created container in interactive mode (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines):
```
podman start -i -l
```
## SEE ALSO
**[podman(1)](podman.1.md)**
## HISTORY
November 2018, Originally compiled by Brent Baude <[email protected]>