command: docker compose pull
short: Pull service images
long: |
    Pulls an image associated with a service defined in a `compose.yaml` file, but does not start containers based on those images
usage: docker compose pull [OPTIONS] [SERVICE...]
pname: docker compose
plink: docker_compose.yaml
options:
    - option: ignore-buildable
      value_type: bool
      default_value: "false"
      description: Ignore images that can be built
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: ignore-pull-failures
      value_type: bool
      default_value: "false"
      description: Pull what it can and ignores images with pull failures
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: include-deps
      value_type: bool
      default_value: "false"
      description: Also pull services declared as dependencies
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: no-parallel
      value_type: bool
      default_value: "true"
      description: DEPRECATED disable parallel pulling
      deprecated: false
      hidden: true
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: parallel
      value_type: bool
      default_value: "true"
      description: DEPRECATED pull multiple images in parallel
      deprecated: false
      hidden: true
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: policy
      value_type: string
      description: Apply pull policy ("missing"|"always")
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: quiet
      shorthand: q
      value_type: bool
      default_value: "false"
      description: Pull without printing progress information
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
inherited_options:
    - option: dry-run
      value_type: bool
      default_value: "false"
      description: Execute command in dry run mode
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
examples: |-
    Consider the following `compose.yaml`:

    ```yaml
    services:
      db:
        image: postgres
      web:
        build: .
        command: bundle exec rails s -p 3000 -b '0.0.0.0'
        volumes:
          - .:/myapp
        ports:
          - "3000:3000"
        depends_on:
          - db
    ```

    If you run `docker compose pull ServiceName` in the same directory as the `compose.yaml` file that defines the service,
    Docker pulls the associated image. For example, to call the postgres image configured as the db service in our example,
    you would run `docker compose pull db`.

    ```console
    $ docker compose pull db
    [+] Running 1/15
     ⠸ db Pulling                                                             12.4s
       ⠿ 45b42c59be33 Already exists                                           0.0s
       ⠹ 40adec129f1a Downloading  3.374MB/4.178MB                             9.3s
       ⠹ b4c431d00c78 Download complete                                        9.3s
       ⠹ 2696974e2815 Download complete                                        9.3s
       ⠹ 564b77596399 Downloading  5.622MB/7.965MB                             9.3s
       ⠹ 5044045cf6f2 Downloading  216.7kB/391.1kB                             9.3s
       ⠹ d736e67e6ac3 Waiting                                                  9.3s
       ⠹ 390c1c9a5ae4 Waiting                                                  9.3s
       ⠹ c0e62f172284 Waiting                                                  9.3s
       ⠹ ebcdc659c5bf Waiting                                                  9.3s
       ⠹ 29be22cb3acc Waiting                                                  9.3s
       ⠹ f63c47038e66 Waiting                                                  9.3s
       ⠹ 77a0c198cde5 Waiting                                                  9.3s
       ⠹ c8752d5b785c Waiting                                                  9.3s
    ```

    `docker compose pull` tries to pull image for services with a build section. If pull fails, it lets you know this service image must be built. You can skip this by setting `--ignore-buildable` flag.
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false