1podman-start(1)() podman-start(1)()
2
3
4
6 podman-start - Start one or more containers
7
8
10 podman start [options] container ...
11
12
13 podman container start [options] container ...
14
15
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
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 ┌─────────┬───────────────────────────────┐
54 │Filter │ 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
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
126 podman(1)
127
128
130 November 2018, Originally compiled by Brent Baude bbaude@redhat.com
131 ⟨mailto:bbaude@redhat.com⟩
132
133
134
135 podman-start(1)()