LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

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

RecommendedBeginner

Everything runs in containers. MongoDB, MeiliSearch, RAG API, and Vector DB are all included automatically.

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

Intermediate

Run LibreChat directly with Node.js. You manage external services like MongoDB and MeiliSearch yourself.

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

Advanced

Deploy on Kubernetes using Helm. Best for production clusters and infrastructure-as-code workflows.

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?

Remote Hosting

DigitalOcean, Railway, Azure, and more

.env Configuration

In-depth guide for environment variables

How is this guide?

Edit on GitHub