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 using container IDs or names as input.
18 The attach and interactive options cannot be used to override the --tty
19 and --interactive options from when the container was created. Starting
20 an already running container with the --attach option, Podman simply
21 attaches 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 "" disables this feature. The
39 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 (CID pre‐ │
60 │ │ fix match by default; accepts │
61 │ │ regex) │
62 ├─────────┼───────────────────────────────┤
63 │name │ [Name] Container's name (ac‐ │
64 │ │ cepts regex) │
65 ├─────────┼───────────────────────────────┤
66 │label │ [Key] or [Key=Value] Label │
67 │ │ assigned to a container │
68 ├─────────┼───────────────────────────────┤
69 │exited │ [Int] Container's exit code │
70 ├─────────┼───────────────────────────────┤
71 │status │ [Status] Container's status: │
72 │ │ 'created', 'exited', │
73 │ │ 'paused', 'running', 'un‐ │
74 │ │ known' │
75 ├─────────┼───────────────────────────────┤
76 │ancestor │ [ImageName] Image or descen‐ │
77 │ │ dant used to create container │
78 ├─────────┼───────────────────────────────┤
79 │before │ [ID] or [Name] Containers │
80 │ │ created before this container │
81 ├─────────┼───────────────────────────────┤
82 │since │ [ID] or [Name] Containers │
83 │ │ created since this container │
84 ├─────────┼───────────────────────────────┤
85 │volume │ [VolumeName] or [Mountpoint‐ │
86 │ │ Destination] Volume mounted │
87 │ │ in container │
88 ├─────────┼───────────────────────────────┤
89 │health │ [Status] healthy or unhealthy │
90 ├─────────┼───────────────────────────────┤
91 │pod │ [Pod] name or full or partial │
92 │ │ ID of pod │
93 ├─────────┼───────────────────────────────┤
94 │network │ [Network] name or full ID of │
95 │ │ network │
96 └─────────┴───────────────────────────────┘
97 --interactive, -i
99 When set to true, keep stdin open even if not attached. The default is
100 false.
101 --latest, -l
104 Instead of providing the container name or ID, use the last created
105 container. Note: the last started container can be from other users of
106 Podman on the host machine. (This option is not available with the re‐
107 mote Podman client, including Mac and Windows (excluding WSL2) ma‐
108 chines)
109 --sig-proxy
112 Proxy received signals to the container process (non-TTY mode only).
113 SIGCHLD, SIGSTOP, and SIGKILL are not proxied.
114 The default is true when attaching, false otherwise.
117
120 podman start mywebserver
121 podman start 860a4b231279 5421ab43b45
124 podman start --interactive --attach 860a4b231279
127 podman start -i -l
130
133 podman(1)
134
137 November 2018, Originally compiled by Brent Baude bbaude@redhat.com
138 ⟨mailto:bbaude@redhat.com⟩
139 podman-start(1)