ragsuite doctor checks that your machine meets the requirements for the install mode you chose (native or docker).
CLI (recommended)
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).