github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-start.1.md.in (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 using 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. Starting an already running container with the *--attach* option, Podman simply
    15  attaches to the container.
    16  
    17  ## OPTIONS
    18  
    19  #### **--all**
    20  
    21  Start all the containers, 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  @@option detach-keys
    29  
    30  #### **--filter**, **-f**
    31  
    32  Filter what containers are going to be started from the given arguments.
    33  Multiple filters can be given with multiple uses of the --filter flag.
    34  Filters with the same key work inclusive with the only exception being
    35  `label` which is exclusive. Filters with different keys always work exclusive.
    36  
    37  Valid filters are listed below:
    38  
    39  | **Filter** | **Description**                                                                  |
    40  |------------|----------------------------------------------------------------------------------|
    41  | id         | [ID] Container's ID (CID prefix match by default; accepts regex)                 |
    42  | name       | [Name] Container's name (accepts regex)                                          |
    43  | label      | [Key] or [Key=Value] Label assigned to a container                               |
    44  | exited     | [Int] Container's exit code                                                      |
    45  | status     | [Status] Container's status: 'created', 'exited', 'paused', 'running', 'unknown' |
    46  | ancestor   | [ImageName] Image or descendant used to create container                         |
    47  | before     | [ID] or [Name] Containers created before this container                          |
    48  | since      | [ID] or [Name] Containers created since this container                           |
    49  | volume     | [VolumeName] or [MountpointDestination] Volume mounted in container              |
    50  | health     | [Status] healthy or unhealthy                                                    |
    51  | pod        | [Pod] name or full or partial ID of pod                                          |
    52  | network    | [Network] name or full ID of network                                             |
    53  | until      | [DateTime] Containers created before the given duration or time.                 |
    54  
    55  @@option interactive
    56  
    57  @@option latest
    58  
    59  @@option sig-proxy
    60  
    61  The default is **true** when attaching, **false** otherwise.
    62  
    63  ## EXAMPLE
    64  
    65  Start specified container:
    66  ```
    67  podman start mywebserver
    68  ```
    69  
    70  Start multiple containers:
    71  ```
    72  podman start 860a4b231279 5421ab43b45
    73  ```
    74  
    75  Start specified container in interactive mode with terminal attached:
    76  ```
    77  podman start --interactive --attach 860a4b231279
    78  ```
    79  
    80  Start last created container in interactive mode (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines):
    81  ```
    82  podman start -i -l
    83  ```
    84  
    85  ## SEE ALSO
    86  **[podman(1)](podman.1.md)**
    87  
    88  ## HISTORY
    89  November 2018, Originally compiled by Brent Baude <bbaude@redhat.com>