DOCKER(1)

NAME

docker-pull - Pull an image or a repository from a registry

SYNOPSIS

docker pull [-a|--all-tags] [--help] NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG]

DESCRIPTION

This command pulls down an image or a repository from a registry. If there is more than one image for a repository (e.g., fedora) then all images for that repository name can be pulled down including any tags (see the option -a or --all-tags).

If you do not specify a REGISTRY_HOST, the command uses Docker's public registry located at registry-1.docker.io by default.

OPTIONS

-a, --all-tags=true|false
   Download all tagged images in the repository. The default is false.

--help
  Print usage statement

EXAMPLE

Pull a repository with multiple images with the -a|--all-tags option set to true.

Note that if the image is previously downloaded then the status would be Status: Image is up to date for fedora.

    $ docker pull --all-tags fedora
    Pulling repository fedora
    ad57ef8d78d7: Download complete
    105182bb5e8b: Download complete
    511136ea3c5a: Download complete
    73bd853d2ea5: Download complete
    Status: Downloaded newer image for fedora
    $ docker images
    REPOSITORY   TAG         IMAGE ID        CREATED      SIZE
    fedora       rawhide     ad57ef8d78d7    5 days ago   359.3 MB
    fedora       20          105182bb5e8b    5 days ago   372.7 MB
    fedora       heisenbug   105182bb5e8b    5 days ago   372.7 MB
    fedora       latest      105182bb5e8b    5 days ago   372.7 MB

Pull a repository with the -a|--all-tags option set to false (this is the default).

    $ docker pull debian
    Using default tag: latest
    latest: Pulling from library/debian
    2c49f83e0b13: Pull complete
    4a5e6db8c069: Pull complete
    Status: Downloaded newer image for debian:latest
    $ docker images
    REPOSITORY   TAG         IMAGE ID        CREATED      SIZE
    debian       latest     4a5e6db8c069     5 days ago   125.1 MB

Pull an image, manually specifying path to Docker's public registry and tag

Note that if the image is previously downloaded then the status would be Status: Image is up to date for registry.hub.docker.com/fedora:20

    $ docker pull registry.hub.docker.com/fedora:20
    Pulling repository fedora
    3f2fed40e4b0: Download complete
    511136ea3c5a: Download complete
    fd241224e9cf: Download complete
    Status: Downloaded newer image for registry.hub.docker.com/fedora:20
    $ docker images
    REPOSITORY   TAG         IMAGE ID        CREATED      SIZE
    fedora       20          3f2fed40e4b0    4 days ago   372.7 MB

HISTORY

April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work. June 2014, updated by Sven Dowideit ⟨SvenDowideit@home.org.au⟩ August 2014, updated by Sven Dowideit ⟨SvenDowideit@home.org.au⟩ April 2015, updated by John Willis ⟨john.willis@docker.com⟩ April 2015, updated by Mary Anthony for v2 ⟨mary@docker.com⟩ September 2015, updated by Sally O'Malley ⟨somalley@redhat.com⟩