github.com/go/docker@v1.12.0-rc2/man/docker-push.1.md (about) 1 % DOCKER(1) Docker User Manuals 2 % Docker Community 3 % JUNE 2014 4 # NAME 5 docker-push - Push an image or a repository to a registry 6 7 # SYNOPSIS 8 **docker push** 9 [**--help**] 10 NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG] 11 12 # DESCRIPTION 13 14 This command pushes an image or a repository to a registry. If you do not 15 specify a `REGISTRY_HOST`, the command uses Docker's public registry located at 16 `registry-1.docker.io` by default. Refer to **docker-tag(1)** for more 17 information about valid image and tag names. 18 19 # OPTIONS 20 **--help** 21 Print usage statement 22 23 # EXAMPLES 24 25 # Pushing a new image to a registry 26 27 First save the new image by finding the container ID (using **docker ps**) 28 and then committing it to a new image name. Note that only a-z0-9-_. are 29 allowed when naming images: 30 31 # docker commit c16378f943fe rhel-httpd 32 33 Now, push the image to the registry using the image ID. In this example the 34 registry is on host named `registry-host` and listening on port `5000`. To do 35 this, tag the image with the host name or IP address, and the port of the 36 registry: 37 38 # docker tag rhel-httpd registry-host:5000/myadmin/rhel-httpd 39 # docker push registry-host:5000/myadmin/rhel-httpd 40 41 Check that this worked by running: 42 43 # docker images 44 45 You should see both `rhel-httpd` and `registry-host:5000/myadmin/rhel-httpd` 46 listed. 47 48 Registry credentials are managed by **docker-login(1)**. 49 50 # HISTORY 51 April 2014, Originally compiled by William Henry (whenry at redhat dot com) 52 based on docker.com source material and internal work. 53 June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> 54 April 2015, updated by Mary Anthony for v2 <mary@docker.com> 55 June 2015, updated by Sally O'Malley <somalley@redhat.com>