DOCKER(1) Docker User Manuals DOCKER(1)

# [NAME](#NAME)

docker-push - Upload an image to a registry

# [SYNOPSIS](#SYNOPSIS)

**docker push \[OPTIONS] NAME\[:TAG]**

# [DESCRIPTION](#DESCRIPTION)

Alias for **docker image push**.

# [OPTIONS](#OPTIONS)

**-a**, **--all-tags**\[=false] Push all tags of an image to the repository

**--platform**="" Push a platform-specific manifest as a single-platform image to the registry. Image index won't be pushed, meaning that other manifests, including attestations won't be preserved. 'os\[/arch\[/variant]]': Explicit platform (eg. linux/amd64)

**-q**, **--quiet**\[=false] Suppress verbose output

# [SEE ALSO](#SEE_ALSO)

[**docker(1)**](/man/os/docker-cli/docker.1)

Sep 2026 Docker Community

---

Document: docker-push(1) from docker-cli 29.8.2-r0 (Chainguard OS)
Source: https://github.com/docker/cli