github.com/portworx/docker@v1.12.1/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>