Files
infrastructure/llm-server/llm/ansible/roles/open_webui
spektr 46dab5dca7
ci-static / secret-scan (push) Successful in 21s
ci-static / yamllint (push) Successful in 30s
ci-static / ansible-syntax (push) Successful in 28s
ci-static / markdown-links (push) Successful in 22s
ci-static / secret-scan (pull_request) Successful in 20s
ci-static / yamllint (pull_request) Successful in 30s
ci-static / ansible-syntax (pull_request) Successful in 27s
ci-static / markdown-links (pull_request) Successful in 20s
M6/GNAI-021: OpenWebUI-Theme gnai-catppuccin-mocha + Ghost-Favicon als read-only Mounts; ai_backup um /etc/gnmon und openwebui-data (SQLite-Snapshot) erweitert
- 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>
2026-11-14 14:37:13 +01:00
..

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-production im Production-Netz gnai-production-llama und erreicht die Engine über http://llama-cpp:8080/v1 — kein Host-Port der Engine nötig.
  • Ingress: 10.0.0.90:8081 (Container-Port 8080); Host-Firewall (gnmon_firewall, Portliste gnmon_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) und OPENAI_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.css wird nach /var/lib/ghostnet-ai/production/openwebui-theme/custom.css deployt und im Quadlet read-only über /app/backend/open_webui/static/custom.css gemountet (Volume=...:ro).
  • index.html lädt /static/custom.css auf jeder Seite — update-sicher: Beim Container-Start kopiert OpenWebUI zwar static/ 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 daher html.light UND html.dark auf dieselbe Mocha-Palette ab (!important gegen die Inline-Styles von setTheme()), sodass das GNMON-Theme unabhängig von der UI-Auswahl immer greift.
  • Verifikation: Task Verify the GNMON theme is served as /static/custom.css prü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 copy ersetzt die Datei (Rename → neuer Inode). Inhaltsänderungen notifies deshalb Restart OpenWebUI unit, und flush_handlers läuft vor den Served-Checks, damit die geprüft wird, was der Neustart neu gebunden hat.
  • Verifikation: GET /static/favicon.png muss byte-identisch zur deployen Datei sein (content_length vs. stat).