1podman-start(1)()                                            podman-start(1)()
2
3
4

NAME

6       podman-start - Start one or more containers
7
8

SYNOPSIS

10       podman start [options] container ...
11
12
13       podman container start [options] container ...
14
15

DESCRIPTION

17       Start  one  or  more containers.  You may use container IDs or names as
18       input.  The attach and interactive options cannot be used  to  override
19       the  --tty  and  --interactive options from when the container was cre‐
20       ated. If you attempt to start a running container with the --attach op‐
21       tion, podman will simply attach to the container.
22
23

OPTIONS

25   --all
26       Start  all  the  containers  created by Podman, default is only running
27       containers.
28
29
30   --attach, -a
31       Attach container's STDOUT and STDERR.  The default is false.  This  op‐
32       tion cannot be used when starting multiple containers.
33
34
35   --detach-keys=sequence
36       Specify  the key sequence for detaching a container. Format is a single
37       character [a-Z] or one or more ctrl-<value> characters where <value> is
38       one  of: a-z, @, ^, [, , or _. Specifying "" will disable this feature.
39       The default is ctrl-p,ctrl-q.
40
41
42   --filter, -f
43       Filter what containers are going to be started  from  the  given  argu‐
44       ments.   Multiple filters can be given with multiple uses of the --fil‐
45       ter flag.  Filters with the same key work inclusive with the  only  ex‐
46       ception being label which is exclusive. Filters with different keys al‐
47       ways work exclusive.
48
49
50       Valid filters are listed below:
51
52
53       ┌─────────┬───────────────────────────────┐
54Filter   Description                   
55       ├─────────┼───────────────────────────────┤
56       │id       │ [ID] Container's ID  (accepts │
57       │         │ regex)                        │
58       ├─────────┼───────────────────────────────┤
59       │name     │ [Name]  Container's name (ac‐ │
60       │         │ cepts regex)                  │
61       ├─────────┼───────────────────────────────┤
62       │label    │ [Key]  or  [Key=Value]  Label │
63       │         │ assigned to a container       │
64       ├─────────┼───────────────────────────────┤
65       │exited   │ [Int] Container's exit code   │
66       ├─────────┼───────────────────────────────┤
67       │status   │ [Status]  Container's status: │
68       │         │ 'created',          'exited', │
69       │         │ 'paused',   'running',   'un‐ │
70       │         │ known'                        │
71       ├─────────┼───────────────────────────────┤
72       │ancestor │ [ImageName] Image or  descen‐ │
73       │         │ dant used to create container │
74       ├─────────┼───────────────────────────────┤
75       │before   │ [ID]   or  [Name]  Containers │
76       │         │ created before this container │
77       ├─────────┼───────────────────────────────┤
78       │since    │ [ID]  or  [Name]   Containers │
79       │         │ created since this container  │
80       ├─────────┼───────────────────────────────┤
81       │volume   │ [VolumeName]  or [Mountpoint‐ │
82       │         │ Destination]  Volume  mounted │
83       │         │ in container                  │
84       ├─────────┼───────────────────────────────┤
85       │health   │ [Status] healthy or unhealthy │
86       ├─────────┼───────────────────────────────┤
87       │pod      │ [Pod] name or full or partial │
88       │         │ ID of pod                     │
89       ├─────────┼───────────────────────────────┤
90       │network  │ [Network] name or full ID  of │
91       │         │ network                       │
92       └─────────┴───────────────────────────────┘
93
94   --interactive, -i
95       Attach container's STDIN. The default is false.
96
97
98   --latest, -l
99       Instead  of  providing  the  container name or ID, use the last created
100       container. If you use methods other than Podman to run containers  such
101       as  CRI-O,  the  last  started  container could be from either of those
102       methods. (This option is not available with the remote  Podman  client,
103       including Mac and Windows (excluding WSL2) machines)
104
105
106   --sig-proxy
107       Proxy  received  signals  to  the process (non-TTY mode only). SIGCHLD,
108       SIGSTOP, and SIGKILL are not proxied. The default is true when  attach‐
109       ing, false otherwise.
110
111

EXAMPLE

113       podman start mywebserver
114
115
116       podman start 860a4b231279 5421ab43b45
117
118
119       podman start --interactive --attach 860a4b231279
120
121
122       podman start -i -l
123
124

SEE ALSO

126       podman(1)
127
128

HISTORY

130       November  2018,  Originally  compiled  by Brent Baude bbaude@redhat.com
131       ⟨mailto:bbaude@redhat.com⟩
132
133
134
135                                                             podman-start(1)()
Impressum