Libre WebUI Documentation

Libre WebUI is a self-hosted AI workspace for chat, local Ollama models, cloud provider plugins, personas, document search, and interactive artifacts. It is designed for people who want a polished WebUI without giving up control of their data or model stack.

Quick Start

npx libre-webui

Libre WebUI opens at http://localhost:8080. Install Ollama first if you want local models, or add provider API keys for cloud models.

Installation Options

Method	Command	Best for
npx	npx libre-webui	Fast local setup
Docker	docker compose up -d	Persistent self-hosting
Docker with external Ollama	docker compose -f docker-compose.external-ollama.yml up -d	Existing Ollama servers
Kubernetes	helm install libre-webui oci://ghcr.io/libre-webui/charts/libre-webui	Cluster deployment
Source	npm install && npm run dev	Development

Core Features

• Streaming chat with local and plugin-backed models
• Model Manager for installed Ollama models, live Ollama Library search, and Ollama Cloud models
• Document Chat for PDF and plain-text files, with keyword search or embeddings
• Personas with model settings, prompts, import/export, memory, and mutation state
• Interactive artifacts for HTML, SVG, JSON, code, and bundled multi-file outputs
• Authentication with local accounts, optional GitHub/Hugging Face OAuth, and optional Cloudflare Turnstile on signup
• Light/dark themes with custom accent colors

AI Providers

Local inference is handled through Ollama. Cloud providers are added through plugins and include OpenAI-compatible APIs plus first-party entries for OpenAI, Anthropic, Google, Groq, Mistral, OpenRouter, Hugging Face, and other compatible services.

The provider model lists are refreshed by the application where supported, so the UI can keep up with new model releases without hardcoding every model in the docs.

Documentation

Getting Started

• Quick Start
• Hardware Requirements
• Working with Models
• Keyboard Shortcuts
• Troubleshooting

Deployment

• Docker
• Docker with External Ollama
• Kubernetes
• Desktop App

Features

• Plugin Architecture
• Hugging Face Hub
• Document Chat
• Artifacts
• Personas
• Qwen3-TTS
• Kyutai TTS

Administration

• Authentication
• Single Sign-On
• Environment Variables
• Database Encryption

Basic Configuration

Create or edit backend/.env:

OLLAMA_BASE_URL=http://localhost:11434
JWT_SECRET=replace-with-a-long-random-secret

# Optional provider keys
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...

# Optional signup protection
TURNSTILE_SITE_KEY=...
TURNSTILE_SECRET_KEY=...

The first local account created in a fresh install becomes the administrator.

Links

• Website
• GitHub
• Issues