mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
29d01b7dde
We now advise people to configure docker group and add to sudo. Mac shouldn't use sudo. Removed sudo from command examples. Left in installation to be removed in installation doc sweep -- removing requires finer grain control. Signed-off-by: Mary Anthony <mary@docker.com>
69 lines
2.3 KiB
Markdown
69 lines
2.3 KiB
Markdown
% DOCKER(1) Docker User Manuals
|
|
% Docker Community
|
|
% JUNE 2014
|
|
# NAME
|
|
docker-pull - Pull an image or a repository from the registry
|
|
|
|
# SYNOPSIS
|
|
**docker pull**
|
|
[**-a**|**--all-tags**[=*false*]]
|
|
[**--help**]
|
|
NAME[:TAG]
|
|
|
|
# DESCRIPTION
|
|
|
|
This command pulls down an image or a repository from the 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.
|
|
It is also possible to specify a non-default registry to pull from.
|
|
|
|
# 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
|
|
# Note that if the image is previously downloaded then the status would be
|
|
# 'Status: Image is up to date for fedora'
|
|
|
|
$ docker pull 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 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 the 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 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>
|