PrivGPT Quick Start

A fast baseline setup for a governed RAG backend behind OpenWebUI, based on the current PrivGPT project structure.

Setup Steps

  1. Run the core stack with Docker Compose: Postgres + pgvector, Ollama, API, Worker, Admin, Keycloak, and optionally OpenWebUI.
  2. Set `DATABASE_URL` and baseline env variables for API/Worker, then run Prisma migrations for the database schema.
  3. Create connector entries in Admin (for example local folder, Google Drive, SharePoint, or OneDrive) and define role rules for ACL mapping.
  4. Ensure users have matching Keycloak workspace roles so retrieval can access expected sources.
  5. Run ingestion and verify documents/chunks are present with the expected ACL roles.
  6. Point OpenWebUI to PrivGPT `/v1/chat/completions` and set OpenAPI auth mode to OAuth token.
  7. Validate governed behavior with test prompts and confirm sources/audit events are captured.