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
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
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
- 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>
This commit is contained in:
@@ -0,0 +1,142 @@
|
||||
# Technischer Arbeitsentwurf
|
||||
|
||||
**Dokumenten-ID:** GNAI-021-TECH
|
||||
**Titel:** Ghostnet-Branding „gnai-catppuccin-mocha" — OpenWebUI-Theme als Default + Favicon „ursprünglicher Geist" auf beiden Sites, update-persistent
|
||||
**Stand:** 2026-11-14
|
||||
**Status:** produktiv seit 2026-11-14 (Betreiber-Go „schalte es live"): Theme live; Favicons nach Betreiberentscheid 2026-11-14 zurück auf den ursprünglichen Geist (Badge-Varianten v2/v5 verworfen) — Monitoring via Image v0.3.6 (unverändert), OpenWebUI via ro-Mounts; Konvergenz `changed=0`
|
||||
**Referenzen:** [DOC-Index](../../../GNAI-000-DOC_Index.md), [GNMON-000](../monitoring/GNMON-000-DOC_Index.md) (Dashboard-Stil M3.1: Catppuccin Mocha, Monospace), Rolle `llm-server/llm/ansible/roles/open_webui/`, OpenWebUI v0.13.3 (digest-gepinnt, `sha256:46b59158…`), Upstream-Quelle `tag v0.13.3`
|
||||
|
||||
> Dieses Dokument beschreibt den technischen Sollzustand des Custom-Themes für
|
||||
> OpenWebUI (`https://chat.ghostnet.selfhost.eu`, intern `10.0.0.90:8081`) und
|
||||
> warum es OpenWebUI-Updates unabhängig übersteht.
|
||||
|
||||
---
|
||||
|
||||
## Änderungsverlauf
|
||||
|
||||
| Datum | Version | Autor | Beschreibung |
|
||||
| --- | --- | --- | --- |
|
||||
| 2026-11-14 | 0.1 | spektr / Mistral Vibe | Erstfassung: Befunde zum Theme-Mechanismus in v0.13.3, update-persistenter Mount, Umsetzung in Rolle `open_webui`, Verifikation |
|
||||
| 2026-11-14 | 0.2 | spektr / Mistral Vibe | Live-Rollout: erster Lauf `changed=3` (Theme-Dir, custom.css, Quadlet), Play brach vor den Handlern an der Served-Prüfung ab (alter Container ohne Mount) — daemon-reload + Unit-Restart manuell nachgezogen, danach `GET /static/custom.css` = 200 mit 5311 Bytes und Marker; zweiter Playbook-Lauf konvergent `changed=0, failed=0`. Der Neustart nach Quadlet-Change ist zugleich der Persistenz-Beweis: OpenWebUIs Start-Wipe von `static/` läuft dabei erneut und kann den ro-Mount nicht anfassen |
|
||||
| 2026-11-14 | 0.3 | spektr / Mistral Vibe | Favicons ergänzt (Abschnitt 5): v2 (Ghost + Pulse-Badge) für das Monitoring-Dashboard, v5 (Ghost + Terminal-Badge) für OpenWebUI — gleiche read-only-Mount-Mechanik |
|
||||
| 2026-11-14 | 0.4 | spektr / Mistral Vibe | Live-Rollout Favicons: OpenWebUI v5 via ro-Mounts OK (alle 5 Dateien byte-identisch serviert, md5-geprüft). Dashboard: Mount-Versuch über `/app/wwwroot` scheiterte (HTTP 500 — MapStaticAssets-Manifest-Mismatch, Befund in Abschnitt 5), deshalb Image-Rebuild `dashboard:v0.3.7` auf der Workstation (Image-ID `a2c15048e188`, favicon md5 `87f78a61…` im Image verifiziert), `podman save`/scp/`load` als gn-dashboard, Tag im Inventory gebumpt, Unit neu gestartet — `GET /favicon.png` = 200, 2488 Bytes, md5 identisch zur Quelle; Playbook konvergent `changed=0, failed=0` |
|
||||
| 2026-11-14 | 0.5 | spektr / Mistral Vibe | Betreiberentscheid: Badge-Varianten verworfen, beide Sites nutzen wieder den ursprünglichen Geist. Monitoring komplett reverted (Quell-PNGs, Rolle, Inventory-Tag v0.3.6; `GET /favicon.png` = 2729 B, md5 `78966788…`). OpenWebUI: Favicon-Dateien gegen byte-identische Kopien des Dashboard-Originals ersetzt (Mounts bleiben); Inode-Befund dokumentiert (copy→Rename→neuer Inode, laufender Container serviert alt — deshalb notify Restart + flush_handlers vor den Checks). Beide Playbooks konvergent `changed=0, failed=0`; alle Favicon-URLs md5-verifiziert |
|
||||
|
||||
---
|
||||
|
||||
## 1. Entscheidung
|
||||
|
||||
Betreiberwunsch 2026-11-14: OpenWebUI soll im Farbschema der Monitor-Website
|
||||
(`mon.ghostnet.selfhost.eu`, GNMON — Catppuccin Mocha, DejaVu Sans Mono,
|
||||
Hacker-TUI-Stil) erscheinen; das Theme soll **Default für alle Nutzer** sein
|
||||
und **unabhängig von OpenWebUI-Updates** bestehen bleiben (kein Image-Patch,
|
||||
kein Fork).
|
||||
|
||||
## 2. Befunde zum Theme-Mechanismus in OpenWebUI v0.13.3
|
||||
|
||||
a) **Es gibt kein server-seitiges Theme.** Die Theme-Wahl (`system`/`light`/
|
||||
`dark`/`oled-dark`/`her`) liegt pro Browser in `localStorage.theme`
|
||||
(`src/app.html`, `src/lib/utils/theme.ts` `setTheme()`); in der DB
|
||||
(`webui.db`) existiert keine Theme-Tabelle (Backend-Modelle/Routers enthalten
|
||||
kein Theme — geprüft gegen `tag v0.13.3`). Ein „Default-Theme für alle
|
||||
Nutzer" lässt sich daher nicht serverseitig erzwingen, sondern nur über
|
||||
CSS, das beide Modi abdeckt (Abschnitt 3).
|
||||
b) **Offizieller Extension-Point: `/static/custom.css`.** `src/app.html` lädt
|
||||
auf jeder Seite `<link rel="stylesheet" href="/static/custom.css">`. Das
|
||||
Image enthält an dieser Stelle eine **leere** Placeholder-Datei
|
||||
(`static/static/custom.css` = leerer Blob). Live verifiziert 2026-11-14:
|
||||
`GET /` enthält den custom.css-Link; `GET /static/custom.css` → 200, 0 Bytes.
|
||||
c) **`/static` wird aus `STATIC_DIR` serviert** (`main.py`: `app.mount('/static',
|
||||
StaticFiles(directory=STATIC_DIR))`, Default `/app/backend/open_webui/static`).
|
||||
Beim Start wiped `config.py` alle Top-Level-Dateien in `STATIC_DIR` und kopiert
|
||||
sie aus dem Image neu (`STATIC_SOURCE_DIR = /app/build/static`). Eine
|
||||
**read-only bind-mountete Einzeldatei** kann dort weder `unlink()`t noch per
|
||||
`copyfile` überschrieben werden (EBUSY/EROFS, beides per `except: pass`
|
||||
ge-swallowt) — sie überlebt jeden Start und jedes Image-Update.
|
||||
d) **Theme-Switch setzt Inline-Styles.** `setTheme()` schreibt
|
||||
`--color-gray-800/850/900/950` als Inline-Style auf `<html>` (dark/oled-dark).
|
||||
Das Theme-CSS braucht daher `!important` auf den Custom-Properties.
|
||||
Ungelayertes CSS (custom.css) schlägt außerdem die `@layer theme`-Variablen
|
||||
von Tailwind v4 (`src/tailwind.css` definiert nur die Graustufen selbst;
|
||||
Akzentfarben kommen aus dem Tailwind-Default-Theme).
|
||||
e) **Farbpalette des Dashboards** stammt aus
|
||||
`llm-server/monitoring/src/Ghostnet.Dashboard/wwwroot/app.css` (`:root`,
|
||||
Catppuccin Mocha: crust `#11111b` … text `#cdd6f4` … mauve `#cba6f7`).
|
||||
|
||||
## 3. Umsetzung
|
||||
|
||||
- Theme-Datei im Repo: `llm-server/llm/ansible/roles/open_webui/files/theme/gnai-catppuccin-mocha.css`.
|
||||
Mapping: Graustufen-Rampe → Mocha-Oberflächen (dark: 950=crust, 900=base,
|
||||
850=mantle, 800=surface0 … 50=text; light: Rampe invertiert auf dieselbe
|
||||
dunkle Palette, damit auch `light`/`system`-Nutzer das Mocha-Theme sehen),
|
||||
Akzent-Rampen (blue→sapphire/blue, green→green/teal, red→red, yellow→yellow,
|
||||
orange→peach, violet→mauve), `color-scheme: dark`, Monospace-Stack
|
||||
(`"DejaVu Sans Mono", ui-monospace, …`), Splash-Screen auf base/peach/grün.
|
||||
- Deployment (Rolle `open_webui`):
|
||||
- `open_webui_theme_dir = /var/lib/ghostnet-ai/production/openwebui-theme`,
|
||||
Datei `custom.css` (Owner `gnai-production`, `0644`).
|
||||
- Quadlet `open-webui.container.j2`:
|
||||
`Volume={{ open_webui_theme_dir }}/custom.css:/app/backend/open_webui/static/custom.css:ro`.
|
||||
- Kein Restart bei reinen Inhaltsänderungen nötig (`/static` wird pro Request
|
||||
von Disk gelesen); der Quadlet-Change triggert einmalig daemon-reload +
|
||||
Restart über die bestehenden Handler.
|
||||
- Verifikation im Playbook: nach dem Health-Check prüft
|
||||
`GET http://10.0.0.90:8081/static/custom.css` auf HTTP 200 **und** den Marker
|
||||
`gnai-catppuccin-mocha` im Body — so fällt ein künftiges Image, das custom.css
|
||||
nicht mehr referenziert/serviert, sofort auf statt still zu verstummen.
|
||||
|
||||
## 4. Warum das Theme Updates überlebt
|
||||
|
||||
- Der Mount liegt **host-seitig im Quadlet** (Ansible, Git), nicht im Image.
|
||||
- Die Theme-Datei liegt **im Repo** und wird idempotent erneut ausgerollt
|
||||
(`changed=0` bei unverändertem Stand).
|
||||
- Beim Container-Start (auch nach Image-Update auf neuen Digest) kopiert
|
||||
OpenWebUI `static/` zwar neu, kann die read-only gemountete Datei aber nicht
|
||||
anfassen (Befund c) — das Theme bleibt aktiv.
|
||||
- Einzige Sollbruchstelle: Ein künftiges OpenWebUI-Release, das den
|
||||
`custom.css`-Link aus `app.html` entfernt. Der Served-Check im Playbook
|
||||
(Abschnitt 3) erkennt das beim nächsten Rollout; bis dahin bleibt das Theme
|
||||
auch über Updates aktiv.
|
||||
|
||||
## 5. Favicons — Betreiberentscheid 2026-11-14: ursprünglicher Geist auf BEIDEN Sites
|
||||
|
||||
Badge-Varianten (v2 Pulse, v5 Terminal aus `~/Downloads/Gemini_Generated_Image_p4vvywp4vvywp4vv.jpg`)
|
||||
wurden gebaut, live genommen und dann vom Betreiber verworfen: Beide Websites
|
||||
verwenden wieder das ursprüngliche Geist-Favicon der Monitoring-Website
|
||||
(`favicon.png` 32x32 md5 `78966788…`, `apple-touch-icon.png` 180x180 md5 `9bc48a15…`).
|
||||
|
||||
- **Monitoring-Dashboard:** alles zurückgesetzt — Quell-PNGs, Rolle
|
||||
`gnmon_dashboard` und Inventory-Tag auf `HEAD`/`v0.3.6` reverted; Unit neu
|
||||
gestartet, `GET /favicon.png` = 2729 Bytes, md5 identisch zum Original. Der
|
||||
Image-Bau v0.3.7 (mit v2-Favicon) bleibt als unbenutztes Image im Store liegen.
|
||||
- **OpenWebUI:** Mount-Mechanik bleibt (funktioniert), nur der Inhalt wurde
|
||||
ersetzt: `roles/open_webui/files/favicon/` enthält jetzt byte-identische Kopien
|
||||
des Dashboard-Originals (favicon.png, apple-touch-icon.png) plus Ableitungen
|
||||
(favicon-96x96.png, favicon.ico 16/32, favicon.svg als Data-URI-Wrapper).
|
||||
Live verifiziert: alle fünf `/static/*`-URLs liefern die erwarteten md5s.
|
||||
- **Befund Inode (14.11.2026):** Single-File-Bind-Mounts binden den Inode bei
|
||||
Container-Erzeugung; Ansible `copy` ersetzt Dateien per Rename (neuer Inode) —
|
||||
der laufende Container serviert dann weiter den alten Inhalt. Deshalb notifyen
|
||||
die Copy-Tasks in der Rolle jetzt `Restart OpenWebUI unit`, und `flush_handlers`
|
||||
läuft vor den Served-Checks.
|
||||
- **Befund .NET (14.11.2026):** Beim Dashboard ist der Mount-Weg prinzipiell
|
||||
unbrauchbar — .NET 10 `MapStaticAssets` liest Content-Length/ETag aus dem
|
||||
Publish-Manifest (`Ghostnet.Dashboard.staticwebassets.endpoints.json`); eine
|
||||
gemountete abweichende Datei lieferte HTTP 500 (kürzer) bzw. Truncation (länger).
|
||||
Favicon-Änderungen am Dashboard erfordern also immer einen Image-Bau + Tag-Bump.
|
||||
|
||||
- Out of scope: OpenWebUI-Splash (`splash.png`/`splash-dark.png`) und
|
||||
`site.webmanifest`/`web-app-manifest-*.png` zeigen weiterhin das OpenWebUI-Logo.
|
||||
|
||||
## 6. Grenzen / Offen
|
||||
|
||||
- Die Theme-Auswahl im UI (Settings → General → Theme) bleibt sichtbar, ist
|
||||
aber visuell neutralisiert (light und dark rendern beide Mocha). Wer explizit
|
||||
„OLED Dark" wählt, bekommt ebenfalls Mocha (Crust statt Schwarz) — bewusst,
|
||||
damit das GNMON-Theme überall greift.
|
||||
- Die DejaVu-Sans-Mono-Datei des Dashboards wird nicht eingebettet (kein
|
||||
Font-Mount ohne neuen Mount-Pfad); auf Linux-Clients mit installierter
|
||||
DejaVu Sans Mono ist der Look identisch, sonst greift der Monospace-Fallback.
|
||||
- Code-Highlighting (hljs) und eingebettete Markdown-Tabellen behalten ihre
|
||||
eigenen Akzente — bewusst nur dezente Anpassungen (Links sapphire, Inline-Code
|
||||
peach, Selection mauve).
|
||||
@@ -15,6 +15,7 @@ Video-Encoding-Workload besitzt einen
|
||||
| [GNAI-009](GNAI-009-PLAN_Llama-Model-Evaluation.md) | Modellbewertung für Swift/Unsloth; Betreiberbeschluss 05.11.2026: Swift 1.5 Q6_K als Production-Profil (Abschnitt 10.4) |
|
||||
| [GNAI-010](GNAI-010-TECH_Llama-Serving.md) | technische Sollkonfiguration für die Modellprofile auf rootless `llama.cpp` mit ROCm; Testing abgenommen (10.5–10.10), Production live seit 06.11.2026 |
|
||||
| [GNAI-020](GNAI-020-TECH_OpenWebUI-WebSearch.md) | Websuche in OpenWebUI: SearXNG mit kuratierten Engines + Native/Agentic Mode (`search_web`/`fetch_url`), UI- und API-Betrieb (Path A/B), produktiv verifiziert seit 12.11.2026 |
|
||||
| [GNAI-021](GNAI-021-TECH_OpenWebUI-Theme.md) | OpenWebUI-Theme „gnai-catppuccin-mocha" (Farbschema des GNMON-Dashboards) als Default für alle Nutzer, update-persistent via read-only `custom.css`-Mount im Quadlet |
|
||||
|
||||
Der übergreifende Projektstand steht im
|
||||
[zentralen Dokumentationsindex](../../../GNAI-000-DOC_Index.md).
|
||||
|
||||
@@ -8,9 +8,17 @@ share (`pve:/media/datenhdd3/Encoding`, operator decision 06.11.2026).
|
||||
## Backup scope
|
||||
|
||||
- `/etc/ghostnet-ai` (all environment config trees)
|
||||
- `/etc/gnmon` (dashboard OIDC env file `dashboard-secrets.env`; added
|
||||
14.11.2026, GNAI-021 follow-up)
|
||||
- `/etc/containers/systemd/users/{980,981,984}` (rootless quadlets,
|
||||
included when present)
|
||||
- `/var/lib/ghostnet-ai/environment-state` (switch state)
|
||||
- `/var/lib/ghostnet-ai/production/openwebui-data` (OpenWebUI app + user
|
||||
data: uploads, cache; added 14.11.2026, GNAI-021 follow-up). The live
|
||||
`webui.db`/`-wal`/`-shm` are **excluded** from the tar; instead a
|
||||
consistent snapshot via SQLite's online-backup API (python3 stdlib) is
|
||||
appended at the same archive path, so a mid-write WAL state is never
|
||||
archived.
|
||||
- `/var/lib/ghostnet-ai/testing/bench/results` (benchmark artifacts)
|
||||
- `/var/lib/ghostnet-ai/shared/models` **without `*.gguf`** — the pinned
|
||||
`SOURCE.yml` manifests make the weights reproducible through the
|
||||
@@ -53,7 +61,13 @@ before it replaces the last good file; retention keeps the newest
|
||||
runtime converges with the restored state.
|
||||
6. For model weights: restore via the model_store role
|
||||
(`--tags models`), then verify the `SOURCE.yml` checksums.
|
||||
7. Re-run the affected environment playbook
|
||||
7. For OpenWebUI user data (`var/lib/ghostnet-ai/production/openwebui-data`):
|
||||
stop the unit (`runuser -u gnai-production -- systemctl --user stop
|
||||
gnai-production-openwebui`), copy the archived `webui.db` back,
|
||||
`chown -R gnai-production:gn-production` the data dir, start the unit,
|
||||
then re-run `playbooks/webui.yml` (re-applies model/tool/config sync)
|
||||
and verify `/health` + model list.
|
||||
8. Re-run the affected environment playbook
|
||||
(`playbooks/ai.yml --tags service`) and verify health.
|
||||
|
||||
Accepted proof (06.11.2026): full-tree extract-and-diff against the
|
||||
|
||||
@@ -25,12 +25,22 @@ ai_backup_script: /usr/local/sbin/gnai-ai-backup
|
||||
# the script only when they exist.
|
||||
ai_backup_paths:
|
||||
- etc/ghostnet-ai
|
||||
- etc/gnmon
|
||||
- etc/containers/systemd/users/980
|
||||
- etc/containers/systemd/users/981
|
||||
- etc/containers/systemd/users/984
|
||||
- var/lib/ghostnet-ai/environment-state
|
||||
- var/lib/ghostnet-ai/production/openwebui-data
|
||||
- var/lib/ghostnet-ai/testing/bench/results
|
||||
|
||||
# OpenWebUI app data (GNAI-021 follow-up, 14.11.2026): the live SQLite
|
||||
# webui.db (and its -wal/-shm sidecars) is EXCLUDED from the tar and replaced
|
||||
# by a consistent snapshot taken via SQLite's online-backup API (python3
|
||||
# stdlib), so a mid-write WAL state is never archived. The snapshot lands at
|
||||
# the same path inside the archive as the live db.
|
||||
ai_backup_openwebui_data_dir: var/lib/ghostnet-ai/production/openwebui-data
|
||||
ai_backup_openwebui_db: webui.db
|
||||
|
||||
# Included without its multi-gigabyte weights: model manifests and any
|
||||
# other metadata below the shared model store.
|
||||
ai_backup_model_store_meta: var/lib/ghostnet-ai/shared/models
|
||||
|
||||
@@ -13,6 +13,8 @@
|
||||
- ai_backup_paths | length > 0
|
||||
- ai_backup_service | length > 0
|
||||
- ai_backup_script is match("^/usr/local/sbin/")
|
||||
- ai_backup_openwebui_data_dir is match("^var/lib/")
|
||||
- ai_backup_openwebui_db is match("^[a-z0-9_.-]+$")
|
||||
fail_msg: AI backup declarations are incomplete or invalid.
|
||||
|
||||
- name: Require the NFS pipeline share to be mounted
|
||||
|
||||
@@ -39,8 +39,40 @@ mkdir -p "$TARGET_DIR"
|
||||
STAMP=$(date +%Y%m%d-%H%M)
|
||||
ARCHIVE="$TARGET_DIR/ghostnet-ai-backup-$STAMP.tar.gz"
|
||||
TMP="$ARCHIVE.tmp"
|
||||
RAWTMP="$ARCHIVE.raw"
|
||||
|
||||
tar -C / -czf "$TMP" "${paths[@]}"
|
||||
# Consistent snapshot of the live OpenWebUI SQLite DB via the online-backup
|
||||
# API (python3 stdlib; sqlite3 CLI is not installed on the host). The live
|
||||
# db + wal/shm are excluded from the archive and the snapshot is appended at
|
||||
# the same archive path.
|
||||
DATA_REL="{{ ai_backup_openwebui_data_dir }}"
|
||||
DB_REL="$DATA_REL/{{ ai_backup_openwebui_db }}"
|
||||
STAGE=""
|
||||
if [ -f "/$DB_REL" ]; then
|
||||
STAGE=$(mktemp -d /tmp/gnai-ai-backup-stage.XXXXXX)
|
||||
mkdir -p "$STAGE/$DATA_REL"
|
||||
python3 - "/$DB_REL" "$STAGE/$DB_REL" <<'PY'
|
||||
import sqlite3, sys
|
||||
src = sqlite3.connect(f"file:{sys.argv[1]}?mode=ro", uri=True)
|
||||
dst = sqlite3.connect(sys.argv[2])
|
||||
with dst:
|
||||
src.backup(dst)
|
||||
dst.close()
|
||||
src.close()
|
||||
PY
|
||||
fi
|
||||
trap 'rm -rf "$STAGE" "$RAWTMP"' EXIT
|
||||
|
||||
# Build uncompressed first so the staged DB can be appended (tar -r does not
|
||||
# work on compressed archives), then gzip.
|
||||
tar -C / -cf "$RAWTMP" \
|
||||
--exclude="$DB_REL" --exclude="$DB_REL-wal" --exclude="$DB_REL-shm" \
|
||||
"${paths[@]}"
|
||||
if [ -n "$STAGE" ]; then
|
||||
tar -C "$STAGE" -rf "$RAWTMP" "$DB_REL"
|
||||
fi
|
||||
gzip -c "$RAWTMP" > "$TMP"
|
||||
rm -f "$RAWTMP"
|
||||
|
||||
if ! tar -tzf "$TMP" > /dev/null 2>&1; then
|
||||
log "ERROR: archive failed the integrity check" >&2
|
||||
|
||||
@@ -43,3 +43,41 @@ 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).
|
||||
|
||||
@@ -48,6 +48,38 @@ open_webui_container_port: 8080
|
||||
# Persistent app data (SQLite DB, uploads, cache).
|
||||
open_webui_data_dir: /var/lib/ghostnet-ai/production/openwebui-data
|
||||
|
||||
# GNMON theme (GNAI-021): Catppuccin Mocha wie das Monitoring-Dashboard.
|
||||
# Wird als einzelne read-only-Datei über den Image-Placeholder
|
||||
# /app/backend/open_webui/static/custom.css gemountet (index.html lädt
|
||||
# /static/custom.css auf jeder Seite). Beim Container-Start kopiert OpenWebUI
|
||||
# sein static/-Verzeichnis zwar neu (config.py), aber eine read-only
|
||||
# Einzeldatei kann weder unlinkt noch überschrieben werden — die Fehler werden
|
||||
# upstream ge-swallowt. Das Theme überlebt Image-Updates, weil der Mount
|
||||
# host-seitig im Quadlet liegt und die Datei aus diesem Repo kommt.
|
||||
open_webui_theme_dir: /var/lib/ghostnet-ai/production/openwebui-theme
|
||||
open_webui_theme_src: theme/gnai-catppuccin-mocha.css
|
||||
open_webui_theme_file: custom.css
|
||||
open_webui_theme_container_path: /app/backend/open_webui/static/custom.css
|
||||
|
||||
# Favicon (GNAI-021): the ORIGINAL ghost favicon of the monitoring site
|
||||
# (byte-identical PNGs from src/Ghostnet.Dashboard/wwwroot/), same
|
||||
# update-persistent mechanism as the theme: read-only single-file mounts over
|
||||
# the image's /app/backend/open_webui/static/* favicon files (app.html
|
||||
# references all of them). Badge variants were tried and rejected by the
|
||||
# operator 2026-11-14 — both sites use the plain ghost.
|
||||
open_webui_favicon_dir: /var/lib/ghostnet-ai/production/openwebui-favicon
|
||||
open_webui_favicon_mounts:
|
||||
- host_file: favicon.png
|
||||
container_path: /app/backend/open_webui/static/favicon.png
|
||||
- host_file: favicon-96x96.png
|
||||
container_path: /app/backend/open_webui/static/favicon-96x96.png
|
||||
- host_file: favicon.svg
|
||||
container_path: /app/backend/open_webui/static/favicon.svg
|
||||
- host_file: favicon.ico
|
||||
container_path: /app/backend/open_webui/static/favicon.ico
|
||||
- host_file: apple-touch-icon.png
|
||||
container_path: /app/backend/open_webui/static/apple-touch-icon.png
|
||||
|
||||
# OIDC phase (M6 public route via NPM + Keycloak). Disabled for the
|
||||
# internal phase; enable together with the Keycloak client
|
||||
# `gnai-openwebui` and the NPM proxy host chat.ghostnet.selfhost.eu.
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 28 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 13 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 3.6 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 2.7 KiB |
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 17 KiB |
@@ -0,0 +1,134 @@
|
||||
/* Ghostnet.AI OpenWebUI theme "gnai-catppuccin-mocha" (GNAI-021).
|
||||
*
|
||||
* Farbschema identisch zum Monitoring-Dashboard (GNMON, app.css):
|
||||
* Catppuccin Mocha + Monospace (DejaVu Sans Mono, wie im Dashboard selbst
|
||||
* gehostet — hier als System-Stack, damit keine Font-Datei gemountet werden
|
||||
* muss).
|
||||
*
|
||||
* Auslieferung: read-only bind mount over
|
||||
* /app/backend/open_webui/static/custom.css (siehe Quadlet). index.html lädt
|
||||
* /static/custom.css auf jeder Seite — update-sicher, weil der Mount host-seitig
|
||||
* im Quadlet liegt und die Datei aus dem Repo kommt.
|
||||
*
|
||||
* Default-Theme: OpenWebUI speichert die Theme-Wahl (light/dark) pro Browser in
|
||||
* localStorage; es gibt keinen server-seitigen Default. Dieses CSS bildet daher
|
||||
* BEIDE Modi (html.light und html.dark) auf dieselbe Mocha-Palette ab — das
|
||||
* GNMON-Theme ist damit für alle Nutzer der Default-Look, unabhängig von der
|
||||
* Theme-Auswahl im UI.
|
||||
*
|
||||
* !important ist nötig, weil setTheme() (src/lib/utils/theme.ts) die Graustufen
|
||||
* 800/850/900/950 als Inline-Style auf <html> setzt; Inline-Styles schlagen
|
||||
* Stylesheet-Regeln ohne !important. Ungelayertes CSS (diese Datei) schlägt
|
||||
* además die @layer-theme-Variablen von Tailwind v4.
|
||||
*/
|
||||
|
||||
/* Basis (gilt immer, auch vor dem Setzen der light/dark-Klasse): Modus-Mapping
|
||||
* für dark — zugleich Akzent-Rampen für beide Modi. */
|
||||
html:root {
|
||||
color-scheme: dark;
|
||||
|
||||
/* Monospace wie GNMON */
|
||||
--font-sans: "DejaVu Sans Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace !important;
|
||||
|
||||
/* Graustufen → Catppuccin Mocha (Dark-Semantik: 950 = tiefster Hintergrund) */
|
||||
--color-gray-50: #cdd6f4 !important; /* text */
|
||||
--color-gray-100: #cdd6f4 !important; /* text */
|
||||
--color-gray-200: #bac2de !important; /* subtext1 */
|
||||
--color-gray-300: #a6adc8 !important; /* subtext0 */
|
||||
--color-gray-400: #7f849c !important; /* overlay1 */
|
||||
--color-gray-500: #6c7086 !important; /* overlay0 */
|
||||
--color-gray-600: #585b70 !important; /* surface2 */
|
||||
--color-gray-700: #45475a !important; /* surface1 */
|
||||
--color-gray-800: #313244 !important; /* surface0 */
|
||||
--color-gray-850: #181825 !important; /* mantle */
|
||||
--color-gray-900: #1e1e2e !important; /* base */
|
||||
--color-gray-950: #11111b !important; /* crust */
|
||||
|
||||
/* In dark mode ist --color-white meist Textfarbe, --color-black Button-Grund */
|
||||
--color-white: #cdd6f4 !important;
|
||||
--color-black: #11111b !important;
|
||||
|
||||
/* Akzenten → Catppuccin (Links/Fokus blau, Erfolg grün, Fehler rot, Warnung gelb) */
|
||||
--color-blue-300: #b4befe !important; /* lavender */
|
||||
--color-blue-400: #74c7ec !important; /* sapphire */
|
||||
--color-blue-500: #89b4fa !important; /* blue */
|
||||
--color-blue-600: #89b4fa !important;
|
||||
--color-blue-700: #74c7ec !important;
|
||||
--color-green-400: #a6e3a1 !important;
|
||||
--color-green-500: #a6e3a1 !important;
|
||||
--color-green-600: #94e2d5 !important; /* teal */
|
||||
--color-red-400: #f38ba8 !important;
|
||||
--color-red-500: #f38ba8 !important;
|
||||
--color-yellow-300: #f9e2af !important;
|
||||
--color-yellow-400: #f9e2af !important;
|
||||
--color-yellow-500: #fab387 !important; /* peach */
|
||||
--color-orange-400: #fab387 !important;
|
||||
--color-orange-500: #fab387 !important;
|
||||
--color-violet-400: #cba6f7 !important; /* mauve */
|
||||
--color-violet-500: #cba6f7 !important;
|
||||
--color-teal-400: #94e2d5 !important;
|
||||
--color-teal-500: #94e2d5 !important;
|
||||
}
|
||||
|
||||
/* html.dark: identisch zur Basis — explizit mit !important gegen die
|
||||
* Inline-Styles, die setTheme() für dark/oled-dark auf <html> schreibt. */
|
||||
html.dark {
|
||||
--color-gray-800: #313244 !important;
|
||||
--color-gray-850: #181825 !important;
|
||||
--color-gray-900: #1e1e2e !important;
|
||||
--color-gray-950: #11111b !important;
|
||||
}
|
||||
|
||||
/* html.light: die Light-Rampe wird auf DERSELBE dunkle Mocha-Palette abgebildet
|
||||
* (bg-white → base, text-gray-900 → text usw.), damit auch Nutzer mit Theme
|
||||
* "light"/"system" (prefers-color-scheme: light) das GNMON-Theme sehen. */
|
||||
html.light {
|
||||
--color-white: #1e1e2e !important; /* Light-Haupthintergrund → base */
|
||||
--color-black: #cdd6f4 !important; /* Light-Text → text */
|
||||
--color-gray-50: #181825 !important; /* helle Panels → mantle */
|
||||
--color-gray-100: #313244 !important; /* → surface0 */
|
||||
--color-gray-200: #45475a !important; /* Borders → surface1 */
|
||||
--color-gray-300: #585b70 !important; /* → surface2 */
|
||||
--color-gray-400: #6c7086 !important; /* → overlay0 */
|
||||
--color-gray-500: #7f849c !important; /* → overlay1 */
|
||||
--color-gray-600: #a6adc8 !important; /* → subtext0 */
|
||||
--color-gray-700: #bac2de !important; /* → subtext1 */
|
||||
--color-gray-800: #cdd6f4 !important; /* → text */
|
||||
--color-gray-850: #cdd6f4 !important;
|
||||
--color-gray-900: #cdd6f4 !important; /* Light-Text → text */
|
||||
--color-gray-950: #cdd6f4 !important;
|
||||
}
|
||||
|
||||
/* Splash-Screen (app.html) auf Mocha trimmen — !important schlägt die
|
||||
* Inline-Styles des Splash-Markups. */
|
||||
#splash-screen {
|
||||
background: #1e1e2e !important;
|
||||
}
|
||||
|
||||
#splash-screen #progress-background {
|
||||
background-color: #313244 !important;
|
||||
}
|
||||
|
||||
#splash-screen #progress-bar {
|
||||
background-color: #a6e3a1 !important;
|
||||
}
|
||||
|
||||
/* Akzente im Fließtext (GNMON: Links sapphire, Code peach) */
|
||||
.marked a,
|
||||
.prose a {
|
||||
color: #74c7ec;
|
||||
}
|
||||
|
||||
.marked a:hover,
|
||||
.prose a:hover {
|
||||
color: #89dceb;
|
||||
}
|
||||
|
||||
code {
|
||||
color: #fab387;
|
||||
}
|
||||
|
||||
::selection {
|
||||
background: rgba(203, 166, 247, 0.35); /* mauve */
|
||||
color: #cdd6f4;
|
||||
}
|
||||
@@ -52,6 +52,45 @@
|
||||
group: "{{ open_webui_user }}"
|
||||
mode: "0750"
|
||||
|
||||
- name: Ensure the OpenWebUI theme directory exists
|
||||
ansible.builtin.file:
|
||||
path: "{{ open_webui_theme_dir }}"
|
||||
state: directory
|
||||
owner: "{{ open_webui_user }}"
|
||||
group: "{{ open_webui_user }}"
|
||||
mode: "0750"
|
||||
|
||||
- name: Deploy the GNMON theme as custom.css (read-only mount target, survives image updates)
|
||||
# Single-file bind mounts pin the inode at container creation; Ansible copy
|
||||
# replaces the file (rename -> new inode), so a content change MUST restart
|
||||
# the unit to re-bind the current file. Hence the notify.
|
||||
ansible.builtin.copy:
|
||||
src: "files/{{ open_webui_theme_src }}"
|
||||
dest: "{{ open_webui_theme_dir }}/{{ open_webui_theme_file }}"
|
||||
owner: "{{ open_webui_user }}"
|
||||
group: "{{ open_webui_user }}"
|
||||
mode: "0644"
|
||||
notify: Restart OpenWebUI unit
|
||||
|
||||
- name: Ensure the OpenWebUI favicon directory exists
|
||||
ansible.builtin.file:
|
||||
path: "{{ open_webui_favicon_dir }}"
|
||||
state: directory
|
||||
owner: "{{ open_webui_user }}"
|
||||
group: "{{ open_webui_user }}"
|
||||
mode: "0750"
|
||||
|
||||
- name: Deploy the ghost favicon files (read-only mount targets, survive image updates)
|
||||
# Same inode caveat as the theme: content changes notify a unit restart.
|
||||
ansible.builtin.copy:
|
||||
src: "files/favicon/{{ item.host_file }}"
|
||||
dest: "{{ open_webui_favicon_dir }}/{{ item.host_file }}"
|
||||
owner: "{{ open_webui_user }}"
|
||||
group: "{{ open_webui_user }}"
|
||||
mode: "0644"
|
||||
loop: "{{ open_webui_favicon_mounts }}"
|
||||
notify: Restart OpenWebUI unit
|
||||
|
||||
- name: Check whether the WebUI secret key already exists
|
||||
ansible.builtin.command:
|
||||
argv:
|
||||
@@ -420,6 +459,13 @@
|
||||
changed_when: false
|
||||
when: not ansible_check_mode
|
||||
|
||||
- name: Flush handlers before the served checks
|
||||
# Content changes to the ro-mounted files notify "Restart OpenWebUI unit";
|
||||
# the restart must happen BEFORE the served checks, otherwise they test the
|
||||
# stale inode still bound by the running container.
|
||||
ansible.builtin.meta: flush_handlers
|
||||
when: not ansible_check_mode
|
||||
|
||||
- name: Wait for the OpenWebUI health endpoint
|
||||
ansible.builtin.uri:
|
||||
url: "http://{{ open_webui_host_addr }}:{{ open_webui_host_port }}/health"
|
||||
@@ -431,6 +477,36 @@
|
||||
until: open_webui_health.status == 200
|
||||
when: not ansible_check_mode
|
||||
|
||||
- name: Verify the GNMON theme is served as /static/custom.css (non-empty, marker present)
|
||||
# Guards the update-persistence contract: if a future OpenWebUI image stops
|
||||
# referencing or serving custom.css, this fails instead of silently losing
|
||||
# the theme.
|
||||
ansible.builtin.uri:
|
||||
url: "http://{{ open_webui_host_addr }}:{{ open_webui_host_port }}/static/custom.css"
|
||||
status_code: 200
|
||||
timeout: 10
|
||||
return_content: true
|
||||
register: open_webui_theme_served
|
||||
failed_when: "'gnai-catppuccin-mocha' not in open_webui_theme_served.content"
|
||||
when: not ansible_check_mode
|
||||
|
||||
- name: Stat the deployed favicon for the served-size comparison
|
||||
ansible.builtin.stat:
|
||||
path: "{{ open_webui_favicon_dir }}/favicon.png"
|
||||
register: open_webui_favicon_stat
|
||||
when: not ansible_check_mode
|
||||
|
||||
- name: Verify the ghost favicon is served as /static/favicon.png (byte-identical to the deployed file)
|
||||
ansible.builtin.uri:
|
||||
url: "http://{{ open_webui_host_addr }}:{{ open_webui_host_port }}/static/favicon.png"
|
||||
status_code: 200
|
||||
timeout: 10
|
||||
register: open_webui_favicon_served
|
||||
failed_when: >-
|
||||
open_webui_favicon_served.content_length | int
|
||||
!= open_webui_favicon_stat.stat.size | int
|
||||
when: not ansible_check_mode
|
||||
|
||||
- name: Verify the engine model list is reachable through OpenWebUI's network
|
||||
ansible.builtin.command:
|
||||
argv:
|
||||
|
||||
@@ -11,6 +11,16 @@ Network={{ open_webui_network_name }}
|
||||
Network={{ open_webui_egress_network_name }}
|
||||
PublishPort={{ open_webui_host_addr }}:{{ open_webui_host_port }}:{{ open_webui_container_port }}
|
||||
Volume={{ open_webui_data_dir }}:/app/backend/data:rw
|
||||
# GNMON theme (GNAI-021): read-only single-file mount over the image's empty
|
||||
# custom.css placeholder. Survives image updates — the mount lives host-side
|
||||
# in this quadlet, and OpenWebUI's startup static re-copy cannot unlink or
|
||||
# overwrite a read-only bind-mounted file.
|
||||
Volume={{ open_webui_theme_dir }}/{{ open_webui_theme_file }}:{{ open_webui_theme_container_path }}:ro
|
||||
# Favicon (GNAI-021): original ghost, same read-only single-file mount pattern
|
||||
# over the image's static favicon files (app.html references all of them).
|
||||
{% for m in open_webui_favicon_mounts %}
|
||||
Volume={{ open_webui_favicon_dir }}/{{ m.host_file }}:{{ m.container_path }}:ro
|
||||
{% endfor %}
|
||||
# Secrets are injected as environment variables, never written to disk or git.
|
||||
Secret={{ open_webui_webui_secret_key_secret }},type=env,target=WEBUI_SECRET_KEY
|
||||
Secret={{ open_webui_engine_api_key_secret }},type=env,target=OPENAI_API_KEY
|
||||
|
||||
Reference in New Issue
Block a user