1podman-start(1)             General Commands Manual            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 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
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 "" disables this feature. The
39       default is ctrl-p,ctrl-q.
40
41
42       This option can also be set in containers.conf(5) file.
43
44
45   --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
52
53       Valid filters are listed below:
54
55
56       ┌─────────┬───────────────────────────────┐
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       │until    │ [DateTime] Containers created │
98       │         │ before  the given duration or │
99       │         │ time.                         │
100       └─────────┴───────────────────────────────┘
101
102   --interactive, -i
103       When set to true, keep stdin open even if not attached. The default  is
104       false.
105
106
107   --latest, -l
108       Instead  of  providing  the  container name or ID, use the last created
109       container.  Note: the last started container can be from other users of
110       Podman on the host machine.  (This option is not available with the re‐
111       mote Podman client, including Mac  and  Windows  (excluding  WSL2)  ma‐
112       chines)
113
114
115   --sig-proxy
116       Proxy  received  signals  to  the  container  process. SIGCHLD, SIGURG,
117       SIGSTOP, and SIGKILL are not proxied.
118
119
120       The default is true when attaching, false otherwise.
121
122

EXAMPLE

124       podman start mywebserver
125
126
127       podman start 860a4b231279 5421ab43b45
128
129
130       podman start --interactive --attach 860a4b231279
131
132
133       podman start -i -l
134
135

SEE ALSO

137       podman(1)
138
139

HISTORY

141       November 2018, Originally compiled  by  Brent  Baude  bbaude@redhat.com
142       ⟨mailto:bbaude@redhat.com⟩
143
144
145
146                                                               podman-start(1)