table of contents
- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- EXAMPLE
- Pull a repository with multiple images
- Note that if the image is previously downloaded then the status would be
- 'Status: Image is up to date for fedora'
- 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'
- HISTORY
other versions
- jessie-backports 1.6.2~dfsg1-1~bpo8+1
- testing 18.09.1+dfsg1-5+b10
- unstable 18.09.1+dfsg1-5+b10
- experimental 18.09.3+dfsg1-1
| DOCKER(1) | JUNE 2014 | DOCKER(1) |
NAME¶
docker-pull - Pull an image or a repository from a registrySYNOPSIS¶
docker pull [ -a|--all-tags[=false]] [ --help] 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 are pulled down including any 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|falseDownload all tagged images in the repository. The default is false. --help
Print usage statement
EXAMPLE¶
Pull a repository with multiple images¶
Note that if the image is previously downloaded then the status would be¶
'Status: Image is up to date for fedora'¶
$ sudo docker pull fedora Pulling repository fedora ad57ef8d78d7: Download complete 105182bb5e8b: Download complete 511136ea3c5a: Download complete 73bd853d2ea5: Download complete Status: Downloaded newer image for fedora $ sudo docker images REPOSITORY TAG IMAGE ID CREATED VIRTUAL 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 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'¶
$ sudo 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 $ sudo docker images REPOSITORY TAG IMAGE ID CREATED VIRTUAL 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⟩| Docker User Manuals | Docker Community |