142 lines
4.1 KiB
Groff
142 lines
4.1 KiB
Groff
'\" t
|
|
.nh
|
|
.TH podman-start 1
|
|
.SH NAME
|
|
podman-start \- Start one or more containers
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman start\fP [\fIoptions\fP] \fIcontainer\fP ...
|
|
|
|
.PP
|
|
\fBpodman container start\fP [\fIoptions\fP] \fIcontainer\fP ...
|
|
|
|
.SH DESCRIPTION
|
|
Start one or more containers using container IDs or names as input. The \fIattach\fP and \fIinteractive\fP
|
|
options cannot be used to override the \fI--tty\fP and \fI--interactive\fP options from when the container
|
|
was created. Starting an already running container with the \fI--attach\fP option, Podman simply
|
|
attaches to the container.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--all\fP
|
|
Start all the containers, default is only running containers.
|
|
|
|
.SS \fB--attach\fP, \fB-a\fP
|
|
Attach container's STDOUT and STDERR. The default is false. This option cannot be used when
|
|
starting multiple containers.
|
|
|
|
.SS \fB--detach-keys\fP=\fIsequence\fP
|
|
Specify the key sequence for detaching a container. Format is a single character \fB[a-Z]\fR or one or more \fBctrl-<value>\fR characters where \fB<value>\fR is one of: \fBa-z\fR, \fB@\fR, \fB^\fR, \fB[\fR, \fB,\fR or \fB_\fR\&. Specifying "" disables this feature. The default is \fIctrl-p,ctrl-q\fP\&.
|
|
|
|
.PP
|
|
This option can also be set in \fBcontainers.conf\fP(5) file.
|
|
|
|
.SS \fB--filter\fP, \fB-f\fP
|
|
Filter what containers are going to be started from the given arguments.
|
|
Multiple filters can be given with multiple uses of the --filter flag.
|
|
Filters with the same key work inclusive with the only exception being
|
|
\fBlabel\fR which is exclusive. Filters with different keys always work exclusive.
|
|
|
|
.PP
|
|
Valid filters are listed below:
|
|
|
|
.TS
|
|
allbox;
|
|
l l
|
|
l l .
|
|
\fB\fBFilter\fP\fP \fB\fBDescription\fP\fP
|
|
id T{
|
|
[ID] Container's ID (CID prefix match by default; accepts regex)
|
|
T}
|
|
name T{
|
|
[Name] Container's name (accepts regex)
|
|
T}
|
|
label T{
|
|
[Key] or [Key=Value] Label assigned to a container
|
|
T}
|
|
exited [Int] Container's exit code
|
|
status T{
|
|
[Status] Container's status: 'created', 'initialized', 'exited', 'paused', 'running', 'unknown'
|
|
T}
|
|
ancestor T{
|
|
[ImageName] Image or descendant used to create container
|
|
T}
|
|
before T{
|
|
[ID] or [Name] Containers created before this container
|
|
T}
|
|
since T{
|
|
[ID] or [Name] Containers created since this container
|
|
T}
|
|
volume T{
|
|
[VolumeName] or [MountpointDestination] Volume mounted in container
|
|
T}
|
|
health [Status] healthy or unhealthy
|
|
pod T{
|
|
[Pod] name or full or partial ID of pod
|
|
T}
|
|
network T{
|
|
[Network] name or full ID of network
|
|
T}
|
|
until T{
|
|
[DateTime] Containers created before the given duration or time.
|
|
T}
|
|
command T{
|
|
[Command] the command the container is executing, only argv[0] is taken
|
|
T}
|
|
.TE
|
|
|
|
.SS \fB--interactive\fP, \fB-i\fP
|
|
When set to \fBtrue\fP, make stdin available to the contained process. If \fBfalse\fP, the stdin of the contained process is empty and immediately closed.
|
|
|
|
.PP
|
|
If attached, stdin is piped to the contained process. If detached, reading stdin will block until later attached.
|
|
|
|
.PP
|
|
\fBCaveat:\fP Podman will consume input from stdin as soon as it becomes available, even if the contained process doesn't request it.
|
|
|
|
.SS \fB--latest\fP, \fB-l\fP
|
|
Instead of providing the container name or ID, use the last created container.
|
|
Note: the last started container can be from other users of Podman on the host machine.
|
|
(This option is not available with the remote Podman client, including Mac and Windows
|
|
(excluding WSL2) machines)
|
|
|
|
.SS \fB--sig-proxy\fP
|
|
Proxy received signals to the container process. SIGCHLD, SIGURG, SIGSTOP, and SIGKILL are not proxied.
|
|
|
|
.PP
|
|
The default is \fBtrue\fP when attaching, \fBfalse\fP otherwise.
|
|
|
|
.SH EXAMPLE
|
|
Start specified container:
|
|
|
|
.EX
|
|
podman start mywebserver
|
|
.EE
|
|
|
|
.PP
|
|
Start multiple containers:
|
|
|
|
.EX
|
|
podman start 860a4b231279 5421ab43b45
|
|
.EE
|
|
|
|
.PP
|
|
Start specified container in interactive mode with terminal attached:
|
|
|
|
.EX
|
|
podman start --interactive --attach 860a4b231279
|
|
.EE
|
|
|
|
.PP
|
|
Start last created container in interactive mode (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines):
|
|
|
|
.EX
|
|
podman start -i -l
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP
|
|
|
|
.SH HISTORY
|
|
November 2018, Originally compiled by Brent Baude bbaude@redhat.com
|
|
\[la]mailto:bbaude@redhat.com\[ra]
|