Local Installation
How to install LibreChat locally
Bundled with Docker
MongoDB
MeiliSearch
RAG API
Vector DB
Docker Compose handles all dependencies. With npm or Helm, you install and configure these services separately.
Choose a method
Docker Compose
RecommendedBeginnerEverything runs in containers. MongoDB, MeiliSearch, RAG API, and Vector DB are all included automatically.
~5 min
Prerequisites
- Git
- Docker Desktop
Commands
git clone https://github.com/danny-avila/LibreChat.git
cd LibreChat
cp .env.example .env
docker compose up -d
MongoDBMeiliSearchRAG APIVector DB
npm
IntermediateRun LibreChat directly with Node.js. You manage external services like MongoDB and MeiliSearch yourself.
~20 min
Prerequisites
- Node.js v20.19+
- Git
- MongoDB
Commands
git clone https://github.com/danny-avila/LibreChat.git
cd LibreChat && npm ci
cp .env.example .env # edit MONGO_URI
npm run backend
External services required
Helm Chart
AdvancedDeploy on Kubernetes using Helm. Best for production clusters and infrastructure-as-code workflows.
~15 min
Prerequisites
- Kubernetes cluster
- kubectl + Helm
Commands
kubectl create secret generic librechat-credentials-env ...
helm install librechat oci://ghcr.io/danny-avila/librechat-chart/librechat
External services required
Not running locally?
How is this guide?