snippetbashTip

crane — Container images managing tool. Some subcommands such as `pull`, `push`, `copy`, etc. have their own

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandimagescraneclimanagingtoolsomecontainer

Problem

How to use the crane command: Container images managing tool. Some subcommands such as pull, push, copy, etc. have their own usage documentation. More information: <https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane.md/>.

Solution

crane — Container images managing tool. Some subcommands such as pull, push, copy, etc. have their own usage documentation. More information: <https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane.md/>.

Log in to a registry:

crane auth login {{registry}} {{[-u|--username]}} {{user}} {{[-p|--password]}} {{password}}

List the repos in a registry:

crane catalog {{registry}} --full-ref

List the tags in a repository:

crane ls {{repository}} {{[-o|--omit-digest-tags]}}

Pull remote images by reference and store their contents locally:

crane pull {{image}} {{tarball}}

Push local image contents to a remote registry:

crane push {{path/to/directory_or_tarball}} {{image}}

Efficiently tag a remote image:

crane tag {{image}} {{tag}}

Efficiently copy a remote image while retaining the digest value:

crane {{[cp|copy]}} {{source}} {{destination}} {{[-a|--all-tags]}}

Delete an image reference from its registry:

crane delete {{image}}

Code Snippets

crane auth login {{registry}} {{[-u|--username]}} {{user}} {{[-p|--password]}} {{password}}

List the repos in a registry

crane catalog {{registry}} --full-ref

List the tags in a repository

crane ls {{repository}} {{[-o|--omit-digest-tags]}}

Pull remote images by reference and store their contents locally

crane pull {{image}} {{tarball}}

Push local image contents to a remote registry

crane push {{path/to/directory_or_tarball}} {{image}}

Context

tldr-pages: common/crane

Revisions (0)

No revisions yet.