canasta doctor

Check target host dependencies

Synopsis

Verify that the target host has the tools required for its orchestrator: Docker + Docker Compose for Compose installs, or kubectl + Helm for Kubernetes installs. Also reports status of optional tools (git, git-crypt, sops, age, crontab) and system resources (memory, disk space).

When an instance is resolved (from -i, or from the current directory), also checks that instance: config and runtime agreement, whether local config edits have been applied, whether CrowdSec is enabled with no CADDY_TRUSTED_PROXIES set, the certificate the origin is actually serving (expired, or silently reissued by Caddy's internal CA after ACME failed), whether the web container's startup composer update failed, and whether the web container is crash-looping or failing its health check, with the startup error from its log and how to fix it.

canasta doctor [flags]

Examples

canasta doctor
canasta doctor --host prod1.example.com
canasta doctor -i mysite

Flags

Flag	Shorthand	Description	Default	Orchestrator
`--docker-host`		Docker API socket on the target. Set this when the target uses rootless podman or rootless Docker (e.g. `unix:///run/user/1000/podman/podman.sock`). Defaults to system Docker's `/var/run/docker.sock`.		Both
`--host`	`-H`	Target host (default: localhost)		Both
`--id`	`-i`	Canasta instance ID — check the host where this instance is registered. Mutually exclusive with --host; --host wins if both are given.	*	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