---
name: "docker-push"
section: "1"
platform: "linux"
package: "docker"
version: "1:29.9.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/docker-push"
---

# docker-push(1)

Upload an image to a registry

## NAME

docker-push - Upload an image to a registry

## SYNOPSIS

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

## DESCRIPTION

Alias for **docker image push**.

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

**[docker(1)](/docker/1.md)**