Open WebUI¶
Einleitung und Rolle¶
Open WebUI ist das webbasierte Chat-Frontend der KI-Infrastruktur. Es bietet eine Oberfläche für Gespräche mit LLMs und kann interne Backends wie LiteLLM und Hermes anbinden. Im Gesamtbild ist Open WebUI der nutzernahe Einstiegspunkt, während LiteLLM als Modell-Gateway und Langfuse als Observability-Schicht dienen.
Die öffentliche Route lautet openwebui.marcosudau.com. Open WebUI verwendet seine eigene Benutzer-, Session- und Authentifizierungslogik; Authentik ist nicht mehr vorgeschaltet.
Persistente Daten und Backup-Relevanz¶
| Pfad | Bedeutung | Backup-Relevanz |
|---|---|---|
/opt/selfhost/data/openwebui |
Datenbank, Einstellungen, Benutzer-/App-Daten, Uploads | hoch |
/opt/selfhost/stacks/openwebui/docker-compose.yml |
Stack-Definition | hoch |
Stack, Container und Docker Compose¶
| Eigenschaft | Wert |
|---|---|
| Stack-Verzeichnis | /opt/selfhost/stacks/openwebui/ |
| Compose-Projekt | openwebui |
| Container | openwebui |
| Image | ghcr.io/open-webui/open-webui:latest |
| Portbindung | 127.0.0.1:3020:8080 |
| Daten-Mount | /opt/selfhost/data/openwebui:/app/backend/data |
| Healthcheck | http://127.0.0.1:8080/health im Container |
| Extra Host | host.docker.internal:host-gateway |
Der Container bindet nur lokal. Externer Zugriff erfolgt über Caddy.
Route und Caddy¶
| Registry-ID | Hostname | Typ | Upstream |
|---|---|---|---|
openwebui |
openwebui.marcosudau.com |
reverse_proxy |
http://127.0.0.1:3020 |
Hostname-Änderungen sollten zusätzlich in Open WebUI geprüft werden, weil Base-URLs, Redirects oder Backend-Verbindungen gespeichert sein können.
Zugehörige Dienste und Abhängigkeiten¶
| Dienst | Rolle |
|---|---|
| LiteLLM | zentraler LLM-Gateway/API-Endpunkt |
| Hermes | optionaler Agent/API-Endpunkt |
| Caddy | HTTPS-Reverse-Proxy |
| Docker | Container-Laufzeit |
Secrets und Umgebungsvariablen¶
Aktuell ist im Compose keine eigene Secret-Datei eingebunden. Die Anwendung verwaltet ihre eigene Konfiguration im Datenverzeichnis. Backend-Verbindungen und Zugangsdaten werden nicht im Klartext dokumentiert.
Betrieb und Prüfung¶
sudo docker compose -f /opt/selfhost/stacks/openwebui/docker-compose.yml ps
curl -I http://127.0.0.1:3020/health
curl -I https://openwebui.marcosudau.com