Skip to main content
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 (including pgvector), Redis, or Docker changes.

From a git clone

What to fix first

1

Postgres

Native mode needs Postgres on 5436 with database ragsuite_v3.
2

Redis

Confirm Redis listens on 6382.
3

pgvector

Vectors are stored in Postgres with the pgvector extension, so doctor checks that the extension is available. Docker: rebuild Postgres with docker compose up -d --build postgres. Host Postgres: install pgvector for your PostgreSQL version (for example brew install pgvector or apt install postgresql-<version>-pgvector).
4

Runtime tools

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

Docker mode

If you chose Docker, confirm the daemon is running and Compose v2 works (docker compose version).
Full matrix: Ports & prerequisites.

Status helpers