% DOCKER(1) Docker User Manuals
% Docker Community
% JUNE 2014
# NAME
docker-push - Push an image or a repository to the registry

# SYNOPSIS
**docker push**
[**-f**|**--force**[=*false*]]
[**--help**]
NAME[:TAG]

# DESCRIPTION
Push an image or a repository to a registry. The default registry is the Docker 
Hub located at [hub.docker.com](https://hub.docker.com/). However the 
image can be pushed to another, perhaps private, registry as demonstrated in 
the example below.

If an image is about to be pushed to Docker registry without *force* flag
supplied, Docker will ask for confirmation.

# OPTIONS
**-f**, **--force**=*true*|*false*
  Force a push to public registry

**--help**
  Print usage statement

# EXAMPLES

# Pushing a new image to a registry

First save the new image by finding the container ID (using **docker ps**)
and then committing it to a new image name:

    # 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.
Default Docker commands will push to the default `hub.docker.com`
registry. Instead, push to the local registry, which is on a host called
registry-host*. 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 `rhel-httpd` and `registry-host:5000/myadmin/rhel-httpd`
listed.

# 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>
