github.com/rentongzhang/docker@v1.8.2-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 are pulled down including any tags. 18 19 If you do not specify a `REGISTRY_HOST`, the command uses Docker's public 20 registry located at `registry-1.docker.io` by default. 21 22 # OPTIONS 23 **-a**, **--all-tags**=*true*|*false* 24 Download all tagged images in the repository. The default is *false*. 25 26 **--help** 27 Print usage statement 28 29 # EXAMPLE 30 31 # Pull a repository with multiple images 32 # Note that if the image is previously downloaded then the status would be 33 # 'Status: Image is up to date for fedora' 34 35 $ docker pull fedora 36 Pulling repository fedora 37 ad57ef8d78d7: Download complete 38 105182bb5e8b: Download complete 39 511136ea3c5a: Download complete 40 73bd853d2ea5: Download complete 41 42 Status: Downloaded newer image for fedora 43 44 $ docker images 45 REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 46 fedora rawhide ad57ef8d78d7 5 days ago 359.3 MB 47 fedora 20 105182bb5e8b 5 days ago 372.7 MB 48 fedora heisenbug 105182bb5e8b 5 days ago 372.7 MB 49 fedora latest 105182bb5e8b 5 days ago 372.7 MB 50 51 # Pull an image, manually specifying path to Docker's public registry and tag 52 # Note that if the image is previously downloaded then the status would be 53 # 'Status: Image is up to date for registry.hub.docker.com/fedora:20' 54 55 $ docker pull registry.hub.docker.com/fedora:20 56 Pulling repository fedora 57 3f2fed40e4b0: Download complete 58 511136ea3c5a: Download complete 59 fd241224e9cf: Download complete 60 61 Status: Downloaded newer image for registry.hub.docker.com/fedora:20 62 63 $ docker images 64 REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 65 fedora 20 3f2fed40e4b0 4 days ago 372.7 MB 66 67 68 # HISTORY 69 April 2014, Originally compiled by William Henry (whenry at redhat dot com) 70 based on docker.com source material and internal work. 71 June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> 72 August 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> 73 April 2015, updated by John Willis <john.willis@docker.com> 74 April 2015, updated by Mary Anthony for v2 <mary@docker.com>