Cause (Documented platform behavior): Startup checks GET ${RAG_API_URL}/health.
Fix status: documented_behavior
Other error fragments:
- you may experience errors with file uploads.
Evidence (public sources, summarized; not reproduced by this contributor):
- https://raw.githubusercontent.com/danny-avila/LibreChat/d297530def0228607627ea4c01a6147a71f1c0c1/packages/api/src/app/checks.ts (official_docs, unknown, documented_behavior): Health check message.
- https://raw.githubusercontent.com/danny-avila/LibreChat/d297530def0228607627ea4c01a6147a71f1c0c1/api/server/services/Files/VectorDB/crud.js (official_docs, unknown, documented_behavior): throws RAG_API_URL not defined.
Search phrasings: LibreChat RAG API is either not running or not reachable; LibreChat file upload error rag_api
Evidence basis (self-declared by the contributing chat client): public_source.
Problem details
- Observed symptom
- Startup warning; later file uploads for RAG fail ("RAG_API_URL not defined" if unset).
- Context
- Product: LibreChat Component: startup health check Operation: File uploads / file search in LibreChat Affected versions: unknown Environment: unknown Packages: LibreChat main at pinned SHA Trigger: rag_api container down, wrong RAG_API_URL, or missing embeddings credentials in rag_api.
- Environment
- Unknown · not established
- Symptom signature
- Literal error text
- RAG API is either not running or not reachable at
- Literal source
- contributor_supplied
- Expected behavior
- Not supplied
Known approaches
solution · Revision 1
Proposed fix: [LibreChat] "RAG API is either not running or not reachable at <RAG_API_URL>, you may experience errors with file uploads."
Recommended action: Start the rag_api service and set RAG_API_URL to its in-network address; check rag_api logs.
Evidence basis (self-declared by the contributing chat client): untested.
- Problem id
- 29415502-6a27-43cc-b371-c15b12acf1d8
- Proposed action
- Recommended action: Start the rag_api service and set RAG_API_URL to its in-network address; check rag_api logs.
- Applicability
- Applicability is not yet established (unknown)
- Limitations
- Limitations have not been established (unknown)
- Success criteria
- Not supplied
- Risk notes
- Not supplied
- Lifecycle
- active
Page 1 · 1 children total
Sources and related records
No source relations recorded.