github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-start.1.md (about)

     1  % podman-start(1)
     2  
     3  ## NAME
     4  podman\-start - Start one or more containers
     5  
     6  ## SYNOPSIS
     7  **podman start** [*options*] *container* ...
     8  
     9  **podman container start** [*options*] *container* ...
    10  
    11  ## DESCRIPTION
    12  Start one or more containers.  You may use container IDs or names as input.  The *attach* and *interactive*
    13  options cannot be used to override the *--tty* and *--interactive* options from when the container
    14  was created. If you attempt to start a running container with the *--attach* option, podman will simply
    15  attach to the container.
    16  
    17  ## OPTIONS
    18  
    19  #### **--all**
    20  
    21  Start all the containers created by Podman, default is only running containers.
    22  
    23  #### **--attach**, **-a**
    24  
    25  Attach container's STDOUT and STDERR.  The default is false. This option cannot be used when
    26  starting multiple containers.
    27  
    28  #### **--detach-keys**=*sequence*
    29  
    30  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 "" will disable this feature. The default is *ctrl-p,ctrl-q*.
    31  
    32  #### **--filter**, **-f**
    33  
    34  Filter what containers are going to be started from the given arguments.
    35  Multiple filters can be given with multiple uses of the --filter flag.
    36  Filters with the same key work inclusive with the only exception being
    37  `label` which is exclusive. Filters with different keys always work exclusive.
    38  
    39  Valid filters are listed below:
    40  
    41  | **Filter**      | **Description**                                                                  |
    42  | --------------- | -------------------------------------------------------------------------------- |
    43  | id              | [ID] Container's ID (accepts regex)                                              |
    44  | name            | [Name] Container's name (accepts regex)                                          |
    45  | label           | [Key] or [Key=Value] Label assigned to a container                               |
    46  | exited          | [Int] Container's exit code                                                      |
    47  | status          | [Status] Container's status: 'created', 'exited', 'paused', 'running', 'unknown' |
    48  | ancestor        | [ImageName] Image or descendant used to create container                         |
    49  | before          | [ID] or [Name] Containers created before this container                          |
    50  | since           | [ID] or [Name] Containers created since this container                           |
    51  | volume          | [VolumeName] or [MountpointDestination] Volume mounted in container              |
    52  | health          | [Status] healthy or unhealthy                                                    |
    53  | pod             | [Pod] name or full or partial ID of pod                                          |
    54  | network         | [Network] name or full ID of network                                             |
    55  
    56  #### **--interactive**, **-i**
    57  
    58  Attach container's STDIN. The default is false.
    59  
    60  #### **--latest**, **-l**
    61  
    62  Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
    63  to run containers such as CRI-O, the last started container could be from either of those methods. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
    64  
    65  #### **--sig-proxy**
    66  
    67  Proxy received signals to the process (non-TTY mode only). SIGCHLD, SIGSTOP, and SIGKILL are not proxied. The default is *true* when attaching, *false* otherwise.
    68  
    69  ## EXAMPLE
    70  
    71  podman start mywebserver
    72  
    73  podman start 860a4b231279 5421ab43b45
    74  
    75  podman start --interactive --attach 860a4b231279
    76  
    77  podman start -i -l
    78  
    79  ## SEE ALSO
    80  **[podman(1)](podman.1.md)**
    81  
    82  ## HISTORY
    83  November 2018, Originally compiled by Brent Baude <bbaude@redhat.com>