Doctor

ragsuite doctor checks that your machine meets the requirements for the install mode you chose (native or docker).

Run ragsuite doctor after init, and again whenever Node, Python, Postgres, Redis, Chroma, or Docker changes.

CLI (recommended)

ragsuite doctor

bash scripts/doctor.sh

Postgres

Native mode needs Postgres on 5436 with database ragsuite_v3.

Redis

Confirm Redis listens on 6382.

Chroma

Native mode expects Chroma on 8004. Docker mode keeps Chroma internal to Compose.

Runtime tools

Use Node.js 18+ (20/22 LTS recommended). Native mode also needs Python 3.14 and Yarn 1.22+.

Docker mode

If you chose Docker, confirm the daemon is running and Compose v2 works (docker compose version).

ragsuite status
ragsuite logs api
ragsuite logs frontend