- open_webui-Rolle: Theme (files/theme/gnai-catppuccin-mocha.css) und Favicon (files/favicon/*, byte-identisch zum Dashboard-Original) werden host-seitig deployt und im Quadlet read-only ueber die Image-Platzhalter in /app/backend/open_webui/static/ gemountet — update-persistent, weil der Mount host-seitig liegt und OpenWebUIs Start-Wipe von static/ eine ro-Datei nicht anfassen kann. Inode-Befund: copy->Rename tauscht den Inode, daher notify Restart + flush_handlers vor den Served-Checks. - Served-Verifikation in der Rolle: /static/custom.css (Marker) und /static/favicon.png (byte-identisch via content_length). - ai_backup: zusaetzliche Pfade etc/gnmon und var/lib/ghostnet-ai/production/openwebui-data; die live webui.db (+wal/shm) wird aus dem tar ausgeschlossen und stattdessen als konsistenter Snapshot via SQLite-Online-Backup-API (python3 stdlib) an derselben Archiv-Position angehaengt (tar uncompressed -> append -> gzip). - Doku: GNAI-021 (neu) + ai-README-Index; Link auf GNMON-000 korrigiert. - Live ausgerollt 14.11.2026 auf 10.0.0.90 (webui.yml + ai.yml konvergent changed=0): custom.css 200/5311 B mit Marker, favicon.png 200/2729 B, alle 6 ro-Mounts am laufenden Container gebunden. Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
open_webui
OpenWebUI chat frontend for the Production LLM environment (GNAI-001
milestone 6). Deployed by playbooks/webui.yml against
inventories/production only.
- Image gepinnt per Digest (
v0.13.3,sha256:46b59158…),Pull=never. - Läuft als
gnai-productionim Production-Netzgnai-production-llamaund erreicht die Engine überhttp://llama-cpp:8080/v1— kein Host-Port der Engine nötig. - Ingress:
10.0.0.90:8081(Container-Port 8080); Host-Firewall (gnmon_firewall, Portlistegnmon_firewall_npm_only_ports) lässt nur NPM (10.0.0.10) durch. - Secrets als Podman-Secrets (
type=env), nie in Git:WEBUI_SECRET_KEY(random, bei Erstanlage erzeugt) undOPENAI_API_KEY(Placeholder; die Engine selbst hat keine Auth). - Daten:
/var/lib/ghostnet-ai/production/openwebui-data. - Interne Phase: lokaler Auth (erster User = Admin). Die öffentliche OIDC-Phase (NPM-Route + Keycloak-Client) folgt in M6.
Modellsichtbarkeit (v0.13 access control)
OpenWebUI zeigt Connection-Modelle Nicht-Admins nur, wenn ein DB-Model-Eintrag
existiert UND ein public read access_grant (principal user/*) greift. Die
Rolle stellt beides idempotent sicher (open_webui_engine_model_id), daher
sehen alle authentifizierten OIDC-User das Modell im Chat-Dropdown.
Websuche (GNAI-020, Native/Agentic Mode)
v0.13.3 nutzt für Websuche die Builtin-Tools search_web/fetch_url
(Native Function Calling ist seit v0.10 Default; params des Modell-Eintrags
bleibt leer). Gates (utils/tools.py + Chat.svelte): global ENABLE_WEB_SEARCH=True
(Default in v0.13 ist False), Modell-Capability meta.capabilities.web_search
und meta.builtinTools.web_search sowie meta.defaultFeatureIds=["web_search"]
(werden vom Model-Sync-Task idempotent gesetzt — ohne defaultFeatureIds startet
jeder NEUE Chat mit dem Web-Search-Toggle AUS und das Modell sieht kein
search_web), pro Request features.web_search bzw. Chat-Toggle, User-
Permission features.web_search (Default true für Rolle user). Engine:
siehe Rolle web_search (SearXNG, kuratierte Engines). ENABLE_RAG_WEB_SEARCH
wurde entfernt — in v0.13.3 existiert der Legacy-RAG-Pfad nicht mehr, ein
Embedding-Modell wird nicht benötigt.
Lang laufende Research-Loops (mehrere search_web/fetch_url-Runden) brauchen
auf dem NPM-Proxy-Host chat.ghostnet.selfhost.eu erhöhte Proxy-Timeouts
(siehe GNAI-020 Abschnitt NPM).
Theme (GNAI-021): GNMON Catppuccin Mocha als Default
files/theme/gnai-catppuccin-mocha.csswird nach/var/lib/ghostnet-ai/production/openwebui-theme/custom.cssdeployt und im Quadlet read-only über/app/backend/open_webui/static/custom.cssgemountet (Volume=...:ro).index.htmllädt/static/custom.cssauf jeder Seite — update-sicher: Beim Container-Start kopiert OpenWebUI zwarstatic/neu (config.py), aber eine read-only Einzeldatei kann weder unlinkt noch überschrieben werden; der Mount liegt host-seitig im Quadlet, die Datei kommt aus Git. Image-Updates (neuer Digest) ändern daran nichts.- Default für alle Nutzer: OpenWebUI speichert die Theme-Wahl (light/dark) nur
pro Browser in
localStorage— es gibt keinen server-seitigen Default. Das CSS bildet daherhtml.lightUNDhtml.darkauf dieselbe Mocha-Palette ab (!importantgegen die Inline-Styles vonsetTheme()), sodass das GNMON-Theme unabhängig von der UI-Auswahl immer greift. - Verifikation: Task
Verify the GNMON theme is served as /static/custom.cssprüft nach dem Health-Check, dass die Datei non-empty mit Marker ausgeliefert wird.
Favicon (GNAI-021): ursprünglicher Geist (wie Monitoring-Website)
files/favicon/(favicon.png 32px und apple-touch-icon.png 180px byte-identisch zum Dashboard-Original, dazu favicon-96x96.png, favicon.ico, favicon.svg als Ableitungen) wird nach/var/lib/ghostnet-ai/production/openwebui-favicon/deployt und im Quadlet read-only über die entsprechenden Dateien in/app/backend/open_webui/static/gemountet (app.html referenziert alle fünf).- Update-persistent wie das Theme: Mount host-seitig im Quadlet, Datei aus Git;
OpenWebUIs Start-Kopie von
static/kann eine ro-Einzeldatei nicht anfassen. - Achtung Inode: Single-File-Bind-Mounts binden den Inode bei der
Container-Erzeugung; Ansible
copyersetzt die Datei (Rename → neuer Inode). Inhaltsänderungen notifies deshalbRestart OpenWebUI unit, undflush_handlersläuft vor den Served-Checks, damit die geprüft wird, was der Neustart neu gebunden hat. - Verifikation:
GET /static/favicon.pngmuss byte-identisch zur deployen Datei sein (content_length vs. stat).