github.com/slene/docker@v1.8.0-rc1/docs/reference/commandline/pull.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "pull"
     4  description = "The pull command description and usage"
     5  keywords = ["pull, image, hub, docker"]
     6  [menu.main]
     7  parent = "smn_cli"
     8  weight=1
     9  +++
    10  <![end-metadata]-->
    11  
    12  # pull
    13  
    14      Usage: docker pull [OPTIONS] NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG]
    15  
    16      Pull an image or a repository from the registry
    17  
    18        -a, --all-tags=false          Download all tagged images in the repository
    19        --disable-content-trust=true  Skip image verification
    20  
    21  Most of your images will be created on top of a base image from the
    22  [Docker Hub](https://hub.docker.com) registry.
    23  
    24  [Docker Hub](https://hub.docker.com) contains many pre-built images that you
    25  can `pull` and try without needing to define and configure your own.
    26  
    27  It is also possible to manually specify the path of a registry to pull from.
    28  For example, if you have set up a local registry, you can specify its path to
    29  pull from it. A repository path is similar to a URL, but does not contain
    30  a protocol specifier (`https://`, for example).
    31  
    32  To download a particular image, or set of images (i.e., a repository),
    33  use `docker pull`:
    34  
    35      $ docker pull debian
    36      # will pull the debian:latest image and its intermediate layers
    37      $ docker pull debian:testing
    38      # will pull the image named debian:testing and any intermediate
    39      # layers it is based on.
    40      $ docker pull debian@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
    41      # will pull the image from the debian repository with the digest
    42      # sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
    43      # and any intermediate layers it is based on.
    44      # (Typically the empty `scratch` image, a MAINTAINER layer,
    45      # and the un-tarred base).
    46      $ docker pull --all-tags centos
    47      # will pull all the images from the centos repository
    48      $ docker pull registry.hub.docker.com/debian
    49      # manually specifies the path to the default Docker registry. This could
    50      # be replaced with the path to a local registry to pull from another source.
    51      # sudo docker pull myhub.com:8080/test-image
    52