Commands / kosa8 doctor

kosa8 doctor

Check that this machine can run kosa8, and repair what is safe to repair

Checks the things that actually stop kosa8 working, in the order they bite: whether this machine can run VMs at all, whether the guest kernel and rootfs are installed, whether the daemon binary carries what the platform requires of it, and whether anything is in a state that will fail later for reasons the error message will not explain.

The checks follow the platform: macOS asks about Virtualization.framework, Linux about KVM and Cloud Hypervisor, and a machine with no local engine about the remote worker it is configured to drive.

Run this first when something fails in a way you cannot account for. Each failed check says what was observed, why it matters, and what fixes it.

With --fix, kosa8 repairs the failures that are safe to repair unattended and tells you what it did. It will not repair anything destructive, whatever you pass it: removing a machine or stopping a daemon might be throwing away work kosa8 cannot see, so those are printed for you to run. --dry-run shows what --fix would do without doing it.

Options