Troubleshooting

This section is symptom-first.

Most FlowLayer incidents during development come from one of these areas:

• config loading and validation
• dependency planning
• readiness gating
• session connectivity and auth
• log retrieval expectations

Start from the page that matches what you see:

• Server Won't Start
• TUI Cannot Connect
• Readiness Stuck
• Dependency Cycle
• Logs Missing

If the issue is still unclear, collect these before asking for help:

• exact server command
• exact client command
• first error line from server output
• whether session API is enabled (-s or session.bind)
• whether auth failures are 401 or 403