Libre WebUI Documentation
Self-hosted AI chat that works with Ollama, OpenAI, Anthropic, and 9+ providers.
Quick Start
The fastest way to get started:
npx libre-webui
Opens at http://localhost:8080. That's it.
Requirements: Ollama for local AI, or API keys for cloud providers.
Installation Options
| Method | Command | Best For |
|---|---|---|
| npx | npx libre-webui | Quick start, testing |
| Docker | docker-compose up -d | Production, includes Ollama |
| Docker (external Ollama) | docker-compose -f docker-compose.external-ollama.yml up -d | When Ollama is already running |
| Kubernetes | helm install libre-webui oci://ghcr.io/libre-webui/charts/libre-webui | Enterprise, scaling |
| From source | npm install && npm run dev | Development |
Core Features
- Real-time streaming chat with dark/light themes
- Document Chat (RAG) - Upload PDFs and chat with your docs
- Custom Personas - AI personalities with memory
- Interactive Artifacts - Live HTML, SVG, code preview
- Text-to-Speech - Multiple voices and providers
AI Providers
Local:
- Ollama (full integration)
Cloud (via plugins):
- OpenAI, Anthropic, Google, Groq, Mistral, OpenRouter, and more
Documentation
Getting Started
- Quick Start - Install and run in 60 seconds
- Hardware Requirements - GPU, RAM, and CPU guide
- Working with Models - Model selection and optimization
- Keyboard Shortcuts - Productivity tips
Deployment
- Docker - Docker and Docker Compose
- Kubernetes - Helm chart deployment
- Desktop App - Native macOS app
Features
- Plugin Architecture - External AI providers
- Document Chat (RAG) - Upload and chat with documents
- Artifacts - Interactive content
- Personas - Custom AI personalities
Administration
- Authentication - User management and SSO
- Single Sign-On - GitHub, Hugging Face OAuth
- Environment Variables - Complete configuration reference
Troubleshooting
- Troubleshooting Guide - Common issues and fixes
- Pro Tips - Advanced workflows and features
Configuration
Edit backend/.env:
# Local AI
OLLAMA_BASE_URL=http://localhost:11434
# Cloud providers (optional)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
Enterprise
Kroonen AI provides professional services:
- On-premise & cloud deployment
- SSO integration (Okta, Azure AD, SAML)
- Custom development
- SLA-backed support
Contact: [email protected]