Troubleshooting

When something is wrong, start with concrete evidence — the running binary, its config, and its log. Three pages cover the common paths.

Termux recovery note: v0.2.22 carries forward the installer fix for the v0.2.20 executable-argument failure that reported unknown command /data/data/com.termux/files/usr/bin/gormes for gormes. See Common errors if an older Termux install is still on PATH.


Doctor	What `gormes doctor` checks, online vs. offline runs, how to read the output
Common errors	Symptom → likely cause → fix table
Logs	Where `gormes.log` lives, how to rotate it, how to grep for tool errors

The fastest first move is always:

which -a gormes
gormes version
gormes doctor --offline