Documentation / Operate
Fix common setup problems
Use the exact error to choose the next check.
Common fixes
| Problem | Next step |
|---|---|
| Unknown service | Match the phase's service to a handlers.json key. |
| Invalid handler JSON | Write one outcome to stdout; put logs on stderr. |
| Report already exists | Choose a new --report filename. |
| Incomplete workflow | Check declared outcomes, requires and terminal completion. |
| Docker unavailable | Start Docker or omit --docker for native execution. |
| Command requires a newer installation | Check installation version and use its supported command set. |
Check the basics
shell
rippflow doctor --handlers handlers.json
rippflow validate workflow.json --handlers handlers.jsonVerified sources
Checked 2026-11-05.
- Local runtime guide 7f5ea32 · main
- CLI command dispatcher 7f5ea32 · main
- Handler failures and limits 7f5ea32 · main
- Version diagnostics 7f5ea32 · main