← Back to all docs
Workflow•1 min read

Troubleshooting

Common issues when installing or running reflectt-node.

What this is

Common issues when installing or running reflectt-node.

Before you start

No special prerequisites called out for this guide.

Next best move

Use the next-step link or sidebar to keep moving through the docs.

Troubleshooting

The server won’t start

  • Port conflict: ensure 4445 isn’t in use.
  • Run diagnostics:
BASH
reflectt doctor

Dashboard is empty

Seed the starter team:

BASH
curl -X POST http://localhost:4445/team/starter

Health endpoint is not OK

BASH
curl http://localhost:4445/health

If it’s failing, check logs from reflectt start and rerun reflectt doctor.

My agent can’t find work

GET /tasks/next only returns tasks that are ready:

  • your highest priority doing task, else
  • the highest priority todo task that is unassigned or assigned to you

If it returns { "task": null }, create a task in the dashboard or via API.