command: docker push
short: Push an image or a repository to a registry
long: "Use `docker push` to share your images to the [Docker Hub](https://hub.docker.com)\nregistry
  or to a self-hosted one.\n\nRefer to the [`docker tag`](tag.md) reference for more
  information about valid\nimage and tag names.\n\nKilling the `docker push` process,
  for example by pressing `CTRL-c` while it is\nrunning in a terminal, terminates
  the push operation.\n\nProgress bars are shown during docker push, which show the
  uncompressed size. The \nactual amount of data that's pushed will be compressed
  before sending, so the uploaded\n size will not be reflected by the progress bar.
  \n\nRegistry credentials are managed by [docker login](login.md).\n\n### Concurrent
  uploads\n\nBy default the Docker daemon will push five layers of an image at a time.\nIf
  you are on a low bandwidth connection this may cause timeout issues and you may
  want to lower\nthis via the `--max-concurrent-uploads` daemon option. See the\n[daemon
  documentation](dockerd.md) for more details."
usage: docker push [OPTIONS] NAME[:TAG]
pname: docker
plink: docker.yaml
options:
- option: disable-content-trust
  value_type: bool
  default_value: "true"
  description: Skip image signing
  deprecated: false
  experimental: false
examples: |-
  ### Push a new image to a registry

  First save the new image by finding the container ID (using [`docker ps`](ps.md))
  and then committing it to a new image name.  Note that only `a-z0-9-_.` are
  allowed when naming images:

  ```bash
  $ 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:

  ```bash
  $ docker tag rhel-httpd registry-host:5000/myadmin/rhel-httpd

  $ docker push registry-host:5000/myadmin/rhel-httpd
  ```

  Check that this worked by running:

  ```bash
  $ docker images
  ```

  You should see both `rhel-httpd` and `registry-host:5000/myadmin/rhel-httpd`
  listed.
deprecated: false
experimental: false