canasta config refresh-template

canasta > config > refresh-template

canasta config refresh-template

List, diff, or adopt template versions of seeded config files

Synopsis

Overwrite an instance's copy of a template-seeded config file (e.g. config/default.vcl, config/settings/global/Vector.php) with the version shipped in the current CLI. These files are copied once when the instance is created and then owned by you, so an upgrade never changes them; use this to adopt an improved shipped version, or to restore a seed file you deleted.

This command is read-only unless --yes is given. With no file argument it lists the seed files whose instance copy differs from the current template. With one or more files it shows the diff but changes nothing; add --yes to overwrite, so review the diff first (your local edits to that file are replaced). Rendered files (.env, wikis.yaml, Caddyfile) belong to 'config regenerate' and per-wiki Settings.php is user-owned; neither is touched here.

canasta config refresh-template [flags]

Examples

canasta config refresh-template
canasta config refresh-template config/default.vcl
canasta config refresh-template config/default.vcl --yes

Flags

Flag	Shorthand	Description	Default	Orchestrator
`--files`		Template-seeded file path(s) to refresh, relative to the instance root (e.g. config/default.vcl)		Both
`--id`	`-i`	Canasta instance ID	*	Both
`--yes`	`-y`	Overwrite the instance copy (without this, only previews the diff)		Both

* Defaults to the Canasta instance matching the current directory, if any.

Global flags

Flag	Shorthand	Description	Default	Required	Orchestrator
`--help`	`-h`	Show help message and exit			Both
`--verbose`	`-v`	Enable verbose output			Both