# Libre WebUI Documentation

> Libre WebUI is a self-hosted, privacy-first AI workspace: chat with local Ollama models or any provider plugin, document chat, artifacts, personas, calendar and automations, and sandboxed Work tasks. Apache-2.0 licensed. This file indexes the complete documentation.

Current release: 0.25.0. Every page below is also available concatenated in [llms-full.txt](https://docs.librewebui.org/llms-full.txt), and deterministic search is served at https://docs.librewebui.org/api/search?q=QUERY.

## Documentation

- [Libre WebUI](https://docs.librewebui.org/): Install Libre WebUI, connect the models you choose, build with agents, and deploy a private AI workspace.
- [Quick Start](https://docs.librewebui.org/quick-start): Get Libre WebUI running with Ollama or provider plugins
- [Working with AI Models](https://docs.librewebui.org/working-with-models): Model selection, Ollama management, cloud provider plugins, and performance guidance for Libre WebUI.
- [Pro Tips](https://docs.librewebui.org/pro-tips): Practical workflows for getting more out of Libre WebUI.
- [Keyboard Shortcuts](https://docs.librewebui.org/keyboard-shortcuts): Keyboard shortcuts available in Libre WebUI.
- [Demo Mode](https://docs.librewebui.org/demo-mode): How Libre WebUI demo mode works for preview deployments.
- [Troubleshooting](https://docs.librewebui.org/troubleshooting): Common Libre WebUI issues and fixes.
- [Copyright & License](https://docs.librewebui.org/copyright): Copyright header management, license information, and legal guidelines for Libre WebUI
- [Plugins](https://docs.librewebui.org/plugin-architecture): Plugin system for AI providers, image generation, text-to-speech, speech-to-text, and embeddings.
- [Document Chat (RAG)](https://docs.librewebui.org/rag-feature): Upload PDF and plain-text files, search them, and include relevant context in Libre WebUI chats.
- [SQLite Storage](https://docs.librewebui.org/sqlite-migration): How Libre WebUI stores application data with SQLite.
- [Authentication & Security](https://docs.librewebui.org/authentication): Authentication, first-user setup, OAuth, roles, Turnstile, and session security in Libre WebUI.
- [Artifacts](https://docs.librewebui.org/artifacts-feature): Render interactive HTML, React components, Mermaid diagrams, SVG, JSON, and code beside chat.
- [Release Automation](https://docs.librewebui.org/release-automation): Release Libre WebUI with evidence-based changelogs, gated checks, immutable tags, and GitHub-to-Forgejo mirroring.
- [Docker with External Ollama](https://docs.librewebui.org/docker-external-ollama): Run Libre WebUI in Docker while connecting to an existing Ollama instance.
- [Personas](https://docs.librewebui.org/persona-development-framework): Create reusable AI personas with model settings, prompts, memory, and import/export.
- [Development Branch Guide](https://docs.librewebui.org/dev-branch): Use the experimental dev branch to test latest features and help improve Libre WebUI. Learn how to report bugs and contribute.
- [Community Charter](https://docs.librewebui.org/charter): The foundational principles, governance model, and ethical guidelines for Libre WebUI
- [Database Encryption](https://docs.librewebui.org/database-encryption): Application-level AES-256-GCM encryption and key handling in Libre WebUI.
- [Single Sign-On](https://docs.librewebui.org/single-sign-on): Configure GitHub and Hugging Face OAuth login in Libre WebUI.
- [Desktop App](https://docs.librewebui.org/electron-desktop-app): Install the Libre WebUI desktop application for macOS, Windows, and Linux, and connect it to a local or remote server.
- [Docker](https://docs.librewebui.org/docker): Deploy Libre WebUI with Docker and Docker Compose.
- [Kubernetes](https://docs.librewebui.org/kubernetes): Deploy Libre WebUI on Kubernetes with Helm.
- [Hardware Requirements](https://docs.librewebui.org/hardware-requirements): Hardware guidance for Libre WebUI, local Ollama models, and container-backed Work tasks.
- [Environment Variables](https://docs.librewebui.org/environment-variables): Supported backend and frontend environment variables in Libre WebUI.
- [Qwen3-TTS Integration](https://docs.librewebui.org/qwen3-tts): Run Qwen3-TTS locally for high-quality, multilingual text-to-speech
- [Kyutai TTS Integration](https://docs.librewebui.org/kyutai-tts): Run Kyutai TTS locally for high-quality text-to-speech with voice cloning
- [Hugging Face Hub](https://docs.librewebui.org/huggingface-hub): Use Hugging Face models and Inference Providers from Libre WebUI.
- [Local GPU Stack](https://docs.librewebui.org/local-gpu-stack): Run Libre WebUI locally with Docker, an external Ollama instance, and GPU-aware model choices.
- [Libre Claw Integration](https://docs.librewebui.org/libre-claw-integration): Connect Libre WebUI to Libre Claw for local agent runs, approvals, schedules, memory, skills, tools, and usage reporting
- [Kimi Code](https://docs.librewebui.org/kimi-code): Use Moonshot AI Kimi K3 and Kimi Code models from Libre WebUI.
- [Work: Isolated Workspaces](https://docs.librewebui.org/workspaces): Use Libre WebUI Work for persistent coding workspaces backed by isolated Docker or Kubernetes sandboxes
- [MLX LM on Apple Silicon](https://docs.librewebui.org/mlx-apple-silicon): Run a local OpenAI-compatible MLX server on macOS and connect it to Libre WebUI.
- [Connect Third-Party and Self-Hosted Providers](https://docs.librewebui.org/provider-connections): Connect bundled, OpenAI-compatible, and self-hosted model APIs through the Libre WebUI Provider connections workspace.
- [Use an Installed Coding Agent as a Chat Model](https://docs.librewebui.org/agent-cli-models): Expose the Claude Code, Codex, OpenCode, or Pi CLI already installed on your server as a selectable Libre WebUI chat model, without adding an API key.
- [Private Remote Deployment](https://docs.librewebui.org/private-remote-deployment): Harden a single-server Libre WebUI deployment behind Cloudflare Access and Tunnel.
- [System Diagnostics & Usage Analytics](https://docs.librewebui.org/system-monitoring): Administrator-only System and Usage pages: live host diagnostics and provider usage metering in Libre WebUI.
- [Video & Audio Generation](https://docs.librewebui.org/media-generation): Generate video, speech, and sound through provider plugins and browse everything in the unified media gallery.
- [Web Search](https://docs.librewebui.org/web-search): Give chats and Work tasks live web search through a self-hosted SearXNG instance. Off by default, admin-enabled, fully private.
- [LongCat AudioDiT Integration](https://docs.librewebui.org/longcat-audiodit): Run LongCat AudioDiT locally for batched text-to-speech and consent-based voice cloning.
- [Data Portability](https://docs.librewebui.org/data-portability): Export and import a versioned per-user data archive.
- [Speech to Text](https://docs.librewebui.org/speech-to-text): Transcribe microphone recordings through configured providers.
- [Capability Contracts](https://docs.librewebui.org/capability-contracts): Generated inventory of every executable provider capability in Libre WebUI.
- [Recovery Readiness](https://docs.librewebui.org/recovery-readiness): Inventory the state that must be coordinated for a reliable Libre WebUI backup and restore.
- [Platform Foundation](https://docs.librewebui.org/platform-foundation): Persistence, storage, coordination, and recovery contracts for Libre WebUI.
- [Global Capability Contracts](https://docs.librewebui.org/global-capability-contracts): Generated inventory of global product capabilities and application routes in Libre WebUI.
- [Calendar](https://docs.librewebui.org/calendar): A personal calendar with one-off and recurring events.
- [Automations](https://docs.librewebui.org/automations): Scheduled AI tasks whose runs land in normal chat sessions.

## Optional

- [OpenAPI 3.0 description of the REST API](https://docs.librewebui.org/openapi.json): every endpoint of a self-hosted deployment
- [Agent instructions](https://docs.librewebui.org/agents.txt): how agents should use these docs
- [API catalog (RFC 9727)](https://docs.librewebui.org/.well-known/api-catalog): machine-readable API discovery
- [Agent skills index](https://docs.librewebui.org/.well-known/agent-skills/index.json): installable SKILL.md files
- [Main website](https://librewebui.org/): project homepage and changelog
