Skip to content
SHC Docs

shc doctor

diagnose and fix system issues

Reference for the doctor CLI group. Source: modules/doctor/commands/.

SubcommandDescription
runrun all diagnoses
listlist registered diagnoses

run all diagnoses

Diagnoses only by default — prescriptions (repairs) run only with an explicit --fix. The sweep runs on the daemon when one is reachable (that is where the database and keycloak checks are wired); with no daemon it degrades to a local diagnose-only pass over this host’s view, and --fix is refused.

FlagTypeRequiredHelp
--fixboolnoapply prescriptions for fixable findings
--category / -cstrnorun only diagnoses in this category

list registered diagnoses

Lists every diagnosis registered with the doctor framework — useful for sanity-checking module wiring and authoring --category filters.

Source: modules/doctor/commands/