Schnellstart
Voraussetzungen
| Voraussetzung | Minimum | Empfohlen |
|---|---|---|
| Node.js | 22.22+ | Neueste LTS-Version |
| RAM | 8 GB | 16 GB+ |
| Speicher | 5 GB | 20 GB+ für Modelle |
| GPU | Optional | 8 GB+ VRAM für schnelle lokale Inferenz |
| Docker | Optional | Für Work-Aufgaben erforderlich |
Libre WebUI funktioniert mit Ollama ausschließlich auf der CPU; kleinere Modelle eignen sich dafür jedoch besser. Für Cloud-Anbieter-Plugins wird nur der jeweilige API-Schlüssel benötigt.
Chat, Dokumente, Artefakte und anbieterbasierte Funktionen benötigen Docker nicht.
Work dagegen schon: Docker muss auf dem Rechner installiert sein, auf dem das Libre-WebUI-Backend
läuft, und der Backend-Prozess muss es aufrufen dürfen. Der Befehl
npx libre-webui installiert Docker nicht. Ist Docker nicht verfügbar, läuft der Rest von
Libre WebUI weiter, während Work Laufzeit nicht verfügbar meldet. Modellbefehle werden
niemals ersatzweise direkt auf dem Host ausgeführt.
Libre WebUI starten
npx libre-webui@latest
Öffne http://localhost:8080. Erstelle das erste Konto; es wird
zum Administrator. Weitere öffentliche Registrierungen bleiben deaktiviert, sofern du nicht
ausdrücklich ENABLE_SIGNUP=true setzt.
Der enthaltene Starter speichert dauerhafte Daten in ~/.libre-webui. Mit einem absoluten
DATA_DIR wählst du einen anderen Ort; relative Werte werden aus dem Verzeichnis aufgelöst,
in dem du npx ausführst.
Ollama installieren
Installiere Ollama und lade ein kleines allgemeines Modell:
ollama pull gemma4:12b
Weitere gute Optionen sind gemma4:26b (MoE), gemma4:31b (dense) und qwen3.8:27b. Im Modellmanager von Libre WebUI kannst du installierte Modelle anzeigen, die Ollama-Bibliothek live durchsuchen und Modelle direkt laden.
Installiere für die semantische Dokumentensuche außerdem ein Embedding-Modell:
ollama pull nomic-embed-text
Cloud-Anbieter hinzufügen
Cloud-Anbieter sind optional. Füge Schlüssel pro Benutzer unter Einstellungen → API-Schlüssel oder
serverweit in backend/.env hinzu (danach Backend neu starten) und aktiviere den Anbieter:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Die Anwendung aktualisiert Anbieter-Modelllisten, sofern unterstützt. Für aktuelle Modellnamen musst du die Dokumentation nicht geöffnet lassen.
Erste Work-Aufgabe starten
Work gibt jeder Aufgabe eine dauerhafte Unterhaltung und ein separates, containergestütztes Dateisystem. Die Funktion steht authentifizierten Administratoren zur Verfügung.
- Installiere und starte Docker auf dem Backend-Host.
- Starte eine Aufgabe über Work im Seitenleistenkopf, das
+-Menü der Tabs, die Startseite oderCmd/Ctrl + Shift + U. - Wähle ein Modell mit Tool-Aufrufen.
- Beschreibe das gewünschte Ergebnis und wähle Ausführen.
- Verfolge es unter Dateien, Aktivität, Git, Terminal und Vorschau.
Die Aufgabe bleibt in der Seitenleiste, sodass du später zu Unterhaltung und Dateien zurückkehren kannst. Das Stoppen einer Ausführung oder Vorschau erhält den Workspace. Das Löschen der Aufgabe entfernt ihn endgültig.
Work kann ein installiertes Ollama-Modell, ein Ollama-Cloud-Modell oder ein konfiguriertes Chat-/Completion-Plugin verwenden. Bei einem entfernten Anbieter zeigt Libre WebUI vorab einen Hinweis: Der Anbieter erhält Unterhaltung, Tooldefinitionen und angeforderte Toolergebnisse. Eine autonome Ausführung kann mehrere kostenpflichtige Aufrufe vornehmen.
Siehe Work: isolierte Workspaces für Laufzeit-, Persistenz-, Netzwerk-, Vorschau- und Sicherheitsdetails.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Erstelle den ersten Administrator im Browser. Registrierungsoption oder Neustart sind nicht nötig; weitere öffentliche Registrierungen sind standardmäßig geschlossen.
Wenn Ollama bereits auf dem Host oder einem anderen Rechner läuft:
docker compose -f docker-compose.external-ollama.yml up -d
Nutze für NVIDIA-GPU-Beschleunigung die enthaltene GPU-Compose-Datei.
Die Repository-Compose-Dateien binden den Docker-Socket des Hosts ein, damit Work verfügbar ist.
Dies gewährt der Anwendung root-äquivalente Hostkontrolle; lies daher zuerst
Work: isolierte Workspaces. Setze unter Linux DOCKER_GID in .env auf die
Socket-Eigentümergruppe. Entferne die Einbindung, wenn Work nicht gewünscht ist.
Auch das enthaltene Ollama ist nur intern erreichbar. Füge
-f docker-compose.ollama-host.yml nur hinzu, wenn ein anderer Hostprozess seine API benötigt;
das Override bindet standardmäßig an Loopback.
Orientierung
Der Tab Start hat Starten (neuer Chat, Inkognito-Chat, neue Work-Aufgabe),
Fortsetzen (letzte Unterhaltungen und Aufgaben) und Entdecken (Notizen, Kalender,
Automatisierungen, Modelle, Personas, Imagine). Dieselben Ziele stehen in Seitenleiste und
Befehlspalette (Cmd/Ctrl + K), die Chats, Work-Aufgaben und Aktionen unscharf sowie Inhalte
von Nachrichten, Notizen und Dokumenten vollständig durchsucht.
- Kalender — benutzerspezifischer Kalender mit Wiederholungen.
- Automatisierungen — geplante KI-Ausführungen als Chat-Sitzungen.
Tastenkürzel
| Kürzel | Aktion |
|---|---|
Cmd/Ctrl + K | Befehlspalette (auch beim Tippen) |
Cmd/Ctrl + Shift + O | Neuer Chat |
Cmd/Ctrl + Shift + U | Neue Work-Aufgabe |
Cmd/Ctrl + B | Seitenleiste umschalten |
Cmd/Ctrl + , | Einstellungen |
Cmd/Ctrl + D | Design umschalten |
? | Einstellungen im Tab Tastenkürzel öffnen |
Esc | Einstellungsdialog schließen |
Enter | Nachricht senden |
Shift + Enter | Neue Zeile |