Quick Start
Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| Node.js | 22.22+ | Latest LTS |
| RAM | 8 GB | 16 GB+ |
| Disk | 5 GB | 20 GB+ for models |
| GPU | Optional | 8 GB+ VRAM for fast local inference |
| Docker | Optional | Required for Work tasks |
Libre WebUI works with CPU-only Ollama, but smaller models are a better fit on CPU. For cloud provider plugins, you only need the relevant API key.
Chat, documents, artifacts, and provider-backed features do not require Docker.
Work does: Docker must be installed on the machine running the Libre WebUI
backend, and the backend process must be allowed to invoke it. The
npx libre-webui command does not install Docker. If Docker is unavailable, the
rest of Libre WebUI continues to run while Work reports Runtime unavailable;
model commands are never run directly on the host as a fallback.
Start Libre WebUI
npx libre-webui
Open http://localhost:8080. Create the first account;
that account becomes the administrator. Later public registration remains
disabled unless you explicitly set ENABLE_SIGNUP=true.
Install Ollama
Install Ollama, then pull a small general model:
ollama pull gemma3:4b
Other good first models are qwen3:8b, deepseek-r1:8b, and mistral. Use the Model Manager in Libre WebUI to browse installed models, search the live Ollama Library, and pull models without leaving the app.
For semantic document search, also install an embedding model:
ollama pull nomic-embed-text
Add Cloud Providers
Cloud providers are optional. Add keys to backend/.env, restart the backend, then enable the provider in Settings:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Provider model lists are refreshed by the app when supported. You do not need to keep the docs open to find the latest model names.
Start Your First Work Task
Work gives each task a persistent conversation and a separate container-backed filesystem. It is available to authenticated administrators.
- Install and start Docker on the machine running the Libre WebUI backend.
- Select Work in the sidebar.
- Choose a model that supports tool calling.
- Describe what you want to build or change, then select Run.
- Inspect the generated files, tool activity, and application preview in the workspace pane.
The task remains in the sidebar so you can return to the same conversation and files later. Stopping a run or preview preserves the workspace. Deleting the task permanently deletes its workspace.
Work can use an installed Ollama model, an Ollama Cloud model, or a configured chat or completion-provider plugin. When you select a remote provider, Libre WebUI shows a disclosure before the run: the provider receives the conversation, tool definitions, and any tool results requested by the model. An autonomous run can make multiple paid provider calls.
See Work: Isolated Workspaces for the runtime, persistence, network, preview, and security details.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Create the first administrator in the browser. No registration flag or restart is required; subsequent public registration is closed by default.
If Ollama is already running on the host or another machine:
docker compose -f docker-compose.external-ollama.yml up -d
For NVIDIA GPU acceleration, use the GPU compose file provided by the repository.
Repository Compose files mount the host Docker socket so Work is available when
Docker is installed. This grants the application root-equivalent control of the
host, so read Work: Isolated Workspaces first. On Linux, set
DOCKER_GID in .env to the group that owns the socket. Remove the mount if
Work is not wanted.
Bundled Ollama is also internal-only. Add
-f docker-compose.ollama-host.yml only when another host process needs its API;
the override binds to loopback by default.
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Cmd/Ctrl + B | Toggle sidebar |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Toggle theme |
? | Keyboard shortcuts |
Enter | Send message |
Shift + Enter | New line |