% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014
docker-push - Push an image or a repository to a registry
docker push [--help] NAME[:TAG] | [REGISTRY_HOST[:REGISTRY_PORT]/]NAME[:TAG]
docker push to share your images to the Docker Hub registry or to a self-hosted one.
Refer to docker-tag(1) for more information about valid image and tag names.
Killing the docker push process, for example by pressing CTRL-c while it is running in a terminal, terminates the push operation.
Registry credentials are managed by docker-login(1).
--disable-content-trust Skip image verification (default true)
--help Print usage statement
First save the new image by finding the container ID (using docker ps) and then committing it to a new image name. Note that only a-z0-9-_. are allowed when naming images:
# docker commit c16378f943fe rhel-httpd
Now, push the image to the registry using the image ID. In this example the registry is on host named
registry-host and listening on port
5000. To do this, tag the image with the host name or IP address, and the port of the registry:
# docker tag rhel-httpd registry-host:5000/myadmin/rhel-httpd # docker push registry-host:5000/myadmin/rhel-httpd
Check that this worked by running:
# docker images
You should see both
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 April 2015, updated by Mary Anthony for v2 email@example.com June 2015, updated by Sally O'Malley firstname.lastname@example.org