canasta list

canasta > list

canasta list

List all registered Canasta instances

Synopsis

Display all Canasta instances in the local registry.

With --cleanup, remove registry entries for instances whose directories are confirmed missing. Entries for hosts that are unreachable (DNS failure, SSH refused, etc.) are left alone — a transient network problem shouldn't cause entries to be silently dropped. Pass --force to remove unreachable entries too, or --dry-run to preview without removing anything.

canasta list [flags]

Examples

canasta list
canasta list --cleanup
canasta list --cleanup --dry-run
canasta list --cleanup --force

Flags

Flag	Shorthand	Description	Default	Required	Orchestrator
--cleanup		Remove stale entries whose directories are confirmed missing			Both
--dry-run		With --cleanup, print what would be removed without removing			Both
--force	-f	With --cleanup, also remove entries for unreachable hosts			Both
--host	-H	Filter output by host (default: all hosts)			Both

Global Flags

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