tldr/pages/common/crane-mutate.md

# crane mutate

> Modify image labels and annotations.
> The container must be pushed to a registry, and the manifest is updated there.
> More information: <https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane_mutate.md>.

- New annotations to set (default []):

`crane mutate {{[-a|--annotation]}}/{{[-l|--label]}} {{annotation/label}}`

- Path to tarball/command/entrypoint/environment variable/exposed-ports to append to image:

`crane mutate {{--append}}/{{--cmd}}/{{--entrypoint}}/{{[-e|--env]}}/{{--exposed-ports}} {{var1 var2 ...}}`

- Path to new tarball of resulting image:

`crane mutate {{[-o|--output]}} {{path/to/tarball}}`

- Repository in the form os/arch{{/variant}}{{:osversion}}{{,<platform>}} to push mutated image:

`crane mutate --set-platform {{platform_name}}`

- New tag reference to apply to mutated image:

`crane mutate {{[-t|--tag]}} {{tag_name}}`

- New user to set:

`crane mutate {{[-u|--user]}} {{username}}`

- New working dir to set:

`crane mutate {{[-w|--workdir]}} {{path/to/workdir}}`

- Display help:

`crane mutate {{[-h|--help]}}`