Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
podman-start(1)		    General Commands Manual	       podman-start(1)

NAME
       podman-start - Start one	or more	containers

SYNOPSIS
       podman start [options] container	...

       podman container	start [options]	container ...

DESCRIPTION
       Start  one  or  more  containers	using container	IDs or names as	input.
       The attach and interactive options cannot be used to override the --tty
       and --interactive options from when the container was created. Starting
       an already running container with the --attach  option,	Podman	simply
       attaches	to the container.

OPTIONS
   --all
       Start all the containers, default is only running containers.

   --attach, -a
       Attach  container's  STDOUT and STDERR.	The default is false. This op-
       tion cannot be used when	starting multiple containers.

   --detach-keys=sequence
       Specify the key sequence	for detaching a	container. Format is a	single
       character [a-Z] or one or more ctrl-<value> characters where <value> is
       one  of:	a-z, @,	^, [, ,	or _. Specifying "" disables this feature. The
       default is ctrl-p,ctrl-q.

       This option can also be set in containers.conf(5) file.

   --filter, -f
       Filter what containers are going	to be started  from  the  given	 argu-
       ments.	Multiple filters can be	given with multiple uses of the	--fil-
       ter flag.  Filters with the same	key work inclusive with	the  only  ex-
       ception being label which is exclusive. Filters with different keys al-
       ways work exclusive.

       Valid filters are listed	below:

       +----------+-------------------------------+
       | Filter	  | Description			  |
       +----------+-------------------------------+
       | id	  | [ID] Container's ID	(CID pre- |
       |	  | fix	match by default; accepts |
       |	  | regex)			  |
       +----------+-------------------------------+
       | name	  | [Name]  Container's	name (ac- |
       |	  | cepts regex)		  |
       +----------+-------------------------------+
       | label	  | [Key]  or  [Key=Value]  Label |
       |	  | assigned to	a container	  |
       +----------+-------------------------------+
       | exited	  | [Int] Container's exit code	  |
       +----------+-------------------------------+
       | status	  | [Status]  Container's status: |
       |	  | 'created',		'exited', |
       |	  | 'paused',	'running',   'un- |
       |	  | known'			  |
       +----------+-------------------------------+
       | ancestor | [ImageName]	Image or  descen- |
       |	  | dant used to create	container |
       +----------+-------------------------------+
       | before	  | [ID]   or  [Name]  Containers |
       |	  | created before this	container |
       +----------+-------------------------------+
       | since	  | [ID]  or  [Name]   Containers |
       |	  | created since this container  |
       +----------+-------------------------------+
       | volume	  | [VolumeName]  or [Mountpoint- |
       |	  | Destination]  Volume  mounted |
       |	  | in container		  |
       +----------+-------------------------------+
       | health	  | [Status] healthy or	unhealthy |
       +----------+-------------------------------+
       | pod	  | [Pod] name or full or partial |
       |	  | ID of pod			  |
       +----------+-------------------------------+
       | network  | [Network]  name or full ID of |
       |	  | network			  |
       +----------+-------------------------------+
       | until	  | [DateTime] Containers created |
       |	  | before the given duration  or |
       |	  | time.			  |
       +----------+-------------------------------+

   --interactive, -i
       When  set  to  true,  make stdin	available to the contained process. If
       false, the stdin	of the contained  process  is  empty  and  immediately
       closed.

       If  attached,  stdin  is	 piped	to the contained process. If detached,
       reading stdin will block	until later attached.

       Caveat: Podman will consume input from stdin  as	 soon  as  it  becomes
       available, even if the contained	process	doesn't	request	it.

   --latest, -l
       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 re-
       mote Podman client, including Mac  and  Windows	(excluding  WSL2)  ma-
       chines)

   --sig-proxy
       Proxy  received	signals	 to  the  container  process. SIGCHLD, SIGURG,
       SIGSTOP,	and SIGKILL are	not proxied.

       The default is true when	attaching, false otherwise.

EXAMPLE
       Start specified container:

       podman start mywebserver

       Start multiple containers:

       podman start 860a4b231279 5421ab43b45

       Start specified container in interactive	mode with terminal attached:

       podman start --interactive --attach 860a4b231279

       Start last created container in interactive mode	(This  option  is  not
       available with the remote Podman	client,	including Mac and Windows (ex-
       cluding WSL2) machines):

       podman start -i -l

SEE ALSO
       podman(1)

HISTORY
       November	 2018,	Originally  compiled  by Brent Baude bbaude@redhat.com
       <mailto:bbaude@redhat.com>

							       podman-start(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-start&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help