1podman-start(1) General Commands Manual podman-start(1)
2
6 podman-start - Start one or more containers
7
10 podman start [options] container ...
11 podman container start [options] container ...
14
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
25 --all
26 Start all the containers created by Podman, default is only running
27 containers.
28 --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 --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 This option can also be set in containers.conf(5) file.
43 --filter, -f
46 Filter what containers are going to be started from the given argu‐
47 ments. Multiple filters can be given with multiple uses of the --fil‐
48 ter flag. Filters with the same key work inclusive with the only ex‐
49 ception being label which is exclusive. Filters with different keys al‐
50 ways work exclusive.
51 Valid filters are listed below:
54 ┌─────────┬───────────────────────────────┐
57 │Filter │ Description │
58 ├─────────┼───────────────────────────────┤
59 │id │ [ID] Container's ID (accepts │
60 │ │ regex) │
61 ├─────────┼───────────────────────────────┤
62 │name │ [Name] Container's name (ac‐ │
63 │ │ cepts regex) │
64 ├─────────┼───────────────────────────────┤
65 │label │ [Key] or [Key=Value] Label │
66 │ │ assigned to a container │
67 ├─────────┼───────────────────────────────┤
68 │exited │ [Int] Container's exit code │
69 ├─────────┼───────────────────────────────┤
70 │status │ [Status] Container's status: │
71 │ │ 'created', 'exited', │
72 │ │ 'paused', 'running', 'un‐ │
73 │ │ known' │
74 ├─────────┼───────────────────────────────┤
75 │ancestor │ [ImageName] Image or descen‐ │
76 │ │ dant used to create container │
77 ├─────────┼───────────────────────────────┤
78 │before │ [ID] or [Name] Containers │
79 │ │ created before this container │
80 ├─────────┼───────────────────────────────┤
81 │since │ [ID] or [Name] Containers │
82 │ │ created since this container │
83 ├─────────┼───────────────────────────────┤
84 │volume │ [VolumeName] or [Mountpoint‐ │
85 │ │ Destination] Volume mounted │
86 │ │ in container │
87 ├─────────┼───────────────────────────────┤
88 │health │ [Status] healthy or unhealthy │
89 ├─────────┼───────────────────────────────┤
90 │pod │ [Pod] name or full or partial │
91 │ │ ID of pod │
92 ├─────────┼───────────────────────────────┤
93 │network │ [Network] name or full ID of │
94 │ │ network │
95 └─────────┴───────────────────────────────┘
96 --interactive, -i
98 When set to true, keep stdin open even if not attached. The default is
99 false.
100 --latest, -l
103 Instead of providing the container name or ID, use the last created
104 container. If you use methods other than Podman to run containers such
105 as CRI-O, the last started container could be from either of those
106 methods. (This option is not available with the remote Podman client,
107 including Mac and Windows (excluding WSL2) machines)
108 --sig-proxy
111 Proxy received signals to the container process (non-TTY mode only).
112 SIGCHLD, SIGSTOP, and SIGKILL are not proxied.
113 The default is true when attaching, false otherwise.
116
119 podman start mywebserver
120 podman start 860a4b231279 5421ab43b45
123 podman start --interactive --attach 860a4b231279
126 podman start -i -l
129
132 podman(1)
133
136 November 2018, Originally compiled by Brent Baude bbaude@redhat.com
137 ⟨mailto:bbaude@redhat.com⟩
138 podman-start(1)