---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# crane push

> Push local image contents to a remote registry.
> More information: <https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane_push.md>.

- Push local image to remote registry:

`crane push {{path/to/tarball}} {{image_name}}`

- Path to file with list of published image references:

`crane push {{path/to/tarball}} {{image_name}} --image-refs {{path/to/filename}}`

- Push a collection of images as a single index (required if path has multiple images):

`crane push {{path/to/tarball}} {{image_name}} --index`

- Display help:

`crane push {{-h|--help}}`
