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 --apply 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 --apply to overwrite, so review the diff first (your local edits to that file are replaced). Rendered files (.env, wikis.yaml, Caddyfile) belong to 'canasta reconcile' and per-wiki Settings.php is user-owned; neither is touched here. --yes is accepted as a deprecated spelling of --apply.

canasta config refresh-template [flags] [FILES...]

Examples

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

Arguments

Argument	Description	Default	Required	Orchestrator
FILES	Template-seeded file path(s) to refresh, relative to the instance root (e.g. config/default.vcl)			Both

Flags

Flag	Shorthand	Description	Default	Required	Orchestrator
--apply		Overwrite the instance copy (without this, only previews the diff)			Both
--id	-i	Canasta instance ID	*		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