github.com/goern/docker@v1.9.0-rc1/man/docker-pull.1.md (about) 1 % DOCKER(1) Docker User Manuals 2 % Docker Community 3 % JUNE 2014 4 # NAME 5 docker-pull - Pull an image or a repository from a registry 6 7 # SYNOPSIS 8 **docker pull** 9 [**-a**|**--all-tags**[=*false*]] 10 [**--help**] 11 NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG] 12 13 # DESCRIPTION 14 15 This command pulls down an image or a repository from a registry. If 16 there is more than one image for a repository (e.g., fedora) then all 17 images for that repository name can be pulled down including any tags 18 (see the option **-a** or **--all-tags**). 19 20 If you do not specify a `REGISTRY_HOST`, the command uses Docker's public 21 registry located at `registry-1.docker.io` by default. 22 23 # OPTIONS 24 **-a**, **--all-tags**=*true*|*false* 25 Download all tagged images in the repository. The default is *false*. 26 27 **--help** 28 Print usage statement 29 30 # EXAMPLE 31 32 ## Pull a repository with multiple images with the -a|--all-tags option set to true. 33 Note that if the image is previously downloaded then the status would be 34 `Status: Image is up to date for fedora`. 35 36 $ docker pull --all-tags fedora 37 Pulling repository fedora 38 ad57ef8d78d7: Download complete 39 105182bb5e8b: Download complete 40 511136ea3c5a: Download complete 41 73bd853d2ea5: Download complete 42 43 Status: Downloaded newer image for fedora 44 45 $ docker images 46 REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 47 fedora rawhide ad57ef8d78d7 5 days ago 359.3 MB 48 fedora 20 105182bb5e8b 5 days ago 372.7 MB 49 fedora heisenbug 105182bb5e8b 5 days ago 372.7 MB 50 fedora latest 105182bb5e8b 5 days ago 372.7 MB 51 52 ## Pull a repository with the -a|--all-tags option set to false (this is the default). 53 54 $ docker pull debian 55 Using default tag: latest 56 latest: Pulling from library/debian 57 2c49f83e0b13: Pull complete 58 4a5e6db8c069: Pull complete 59 60 Status: Downloaded newer image for debian:latest 61 62 $ docker images 63 REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 64 debian latest 4a5e6db8c069 5 days ago 125.1 MB 65 66 67 ## Pull an image, manually specifying path to Docker's public registry and tag 68 Note that if the image is previously downloaded then the status would be 69 `Status: Image is up to date for registry.hub.docker.com/fedora:20` 70 71 $ docker pull registry.hub.docker.com/fedora:20 72 Pulling repository fedora 73 3f2fed40e4b0: Download complete 74 511136ea3c5a: Download complete 75 fd241224e9cf: Download complete 76 77 Status: Downloaded newer image for registry.hub.docker.com/fedora:20 78 79 $ docker images 80 REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 81 fedora 20 3f2fed40e4b0 4 days ago 372.7 MB 82 83 84 # HISTORY 85 April 2014, Originally compiled by William Henry (whenry at redhat dot com) 86 based on docker.com source material and internal work. 87 June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> 88 August 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> 89 April 2015, updated by John Willis <john.willis@docker.com> 90 April 2015, updated by Mary Anthony for v2 <mary@docker.com> 91 September 2015, updated by Sally O'Malley <somalley@redhat.com>