# chainctl images overlays update

URL: https://edu.chainguard.dev/platform/chainctl/chainctl-docs/chainctl_images_overlays_update.md
Last Modified: September 29, 2026
Tags: chainctl, Reference, Product

 chainctl images overlays update Update a Custom Assembly overlay’s name or configuration.
Synopsis Update a Custom Assembly overlay’s name, configuration, or both.
–package and –file replace the stored configuration wholesale; they do not merge with it. Repos the overlay is attached to are rebuilt with the new configuration. An update that would conflict with another overlay attached to the same tags is rejected.
chainctl images overlays update <UID|NAME> [flags] Examples # Rename an overlay chainctl images overlays update my-overlay --name my-renamed-overlay # Replace an overlay's configuration from a file chainctl images overlays update my-overlay -f overlay.yaml Options -f, --file chainctl images repos build The name of the YAML file containing the overlay configuration, the same shape chainctl images repos build accepts. Replaces the stored config wholesale and takes precedence over --package. --name string New overlay name. --package strings Package to include (repeatable). Declares the FULL replacement set; the stored config is replaced wholesale. Options inherited from parent commands --api string The url of the Chainguard platform API. (default "https://console-api.enforce.dev") --audience string The Chainguard token audience to request. (default "https://console-api.enforce.dev") --config string A specific chainctl config file. Uses CHAINCTL_CONFIG environment variable if a file is not passed explicitly. --console string The url of the Chainguard platform Console. (default "https://console.chainguard.dev") --force-color Force color output even when stdout is not a TTY. -h, --help Help for chainctl --issuer string The url of the Chainguard STS endpoint. (default "https://issuer.enforce.dev") --log-level string Set the log level (debug, info) (default "ERROR") -o, --output string Output format. One of: [csv, env, go-template, id, json, markdown, none, table, terse, tree, wide] -v, --v int Set the log verbosity level. SEE ALSO chainctl images overlays	- Manage Custom Assembly overlays and the repos they are attached to.