diff --git a/docs/BEDIENUNG.md b/docs/BEDIENUNG.md index f7e4015..54f7c60 100644 --- a/docs/BEDIENUNG.md +++ b/docs/BEDIENUNG.md @@ -1,22 +1,30 @@ -# Bedienung — der Box-Wart im Alltag +# Bedienung — der Homelab Orchestrator im Alltag _Stand 24.09.2026. Für dich als Nutzer. Technische Einzelheiten stehen in [BETRIEB.md](BETRIEB.md)._ **Kurz gesagt:** Die KI-Box kümmert sich selbst um sich. Du bekommst Nachrichten auf Telegram. Handeln musst du nur, -wenn eine Nachricht es sagt oder auf der Startseite etwas gelb oder rot leuchtet. +wenn eine Nachricht es sagt oder in einem Cockpit etwas gelb oder rot leuchtet. Updates im Homelab spielst du selbst +per Knopf ein. -Der Homelab Orchestrator bekommt später einen zweiten Bereich für den Proxmox-PC („Homelab"). Heute gibt es nur den -Bereich für die KI-Box, den Box-Wart. +Der Orchestrator hat zwei getrennte Bereiche: **KI-Box** (der Box-Wart) und **Homelab** (der Proxmox-PC mit seinen +Containern und Arcane). ## So kommst du hin -Im Heimnetz im Browser `http://192.168.178.151:9001` öffnen, am PC oder am Handy. Oben (am Handy unten) stehen die -drei Seiten **Start**, **Updates** und **Modelle**. Rechts oben (am Handy unter **Mehr**) findest du das -Hermes-Dashboard, **Dienste und Protokolle** und die **Einstellungen**. +Im Heimnetz im Browser `http://192.168.178.151:9001` öffnen (oder den Homelab-Teil unter +`http://192.168.178.31:9001` — beide zeigen dasselbe), am PC oder am Handy. Links steht die Menüführung, am Handy +hinter dem Menü-Knopf oben links: + +- **KI-Box:** **Cockpit** (die Startseite), **Updates**, **Modelle**, dazu **Dienste und Protokolle** und das + Hermes-Dashboard. +- **Homelab:** **Cockpit** und **Updates**. +- Ganz unten die **Einstellungen**. + +Jeder Bereich zeigt oben, ob er online ist, und neben „Updates“ die Zahl der Updates, die bereitstehen. Wichtige Knöpfe fragen vorher nach. Was du auslöst, bestätigt eine kurze Meldung unten rechts. -## Start +## KI-Box · Cockpit - **Große Leuchte oben links:** - grün „Alles in Ordnung": nichts zu tun; @@ -37,7 +45,7 @@ Wichtige Knöpfe fragen vorher nach. Was du auslöst, bestätigt eine kurze Meld Updates am Sonntag. - **Radar-Kasten:** ob das Modell-Radar gerade einen Kandidaten hat; „Ansehen" führt zur Seite Modelle. -## Updates +## KI-Box · Updates - Jede Zeile ist ein Baustein: Betriebssystem, Motor (llama.cpp), llama-swap, Hermes. Du siehst, was läuft, was neu wäre und was sich ändert. @@ -54,7 +62,7 @@ Wichtige Knöpfe fragen vorher nach. Was du auslöst, bestätigt eine kurze Meld „Zurückspielen" setzt die Einstellungen von Hermes und llama-swap auf den Stand dieser Sicherung; vorher sichert die Box den jetzigen Stand. Lucys Gedächtnis bleibt dabei erhalten. -## Modelle +## KI-Box · Modelle - **Speicher:** wie voll der Arbeitsspeicher ist. Die gelbe Linie bei etwa 115 GB ist die Grenze; darüber wird es eng. - **Hirn** (für Lucy, NerdQuiz und OpenChamber bei Kleinkram) und **Coder** (für OpenChamber zum Planen und Bauen): @@ -73,6 +81,30 @@ Wichtige Knöpfe fragen vorher nach. Was du auslöst, bestätigt eine kurze Meld abgeschaltete Alt-Units, die nichts mehr nutzt. Die Box kennt sie aus einer festen Liste und zeigt nur, was noch da ist und von keinem laufenden Dienst gebraucht wird. „Löschen" fragt nach und ist endgültig. +## Homelab · Cockpit + +- **Große Leuchte oben links:** grün „Alles aktuell“; cyan mit der Zahl der Updates, die bereitstehen (drücken führt + zu den Updates); gelb bei Hinweisen oder wenn der Ausführer auf dem Proxmox-Host schweigt; rot, wenn ein Gerät + nicht antwortet. +- **Eine Lampe je Gerät** (Proxmox-Host, die Container, Arcane): grün mit der laufenden Version, cyan mit der neuen + Version oder der Zahl der Pakete, rot bei „antwortet nicht“. +- **Hinweise** des Homelab-Wächters, falls es welche gibt. +- **Geräte:** je Gerät App-Version, Stand der Pakete und ob es im Netz antwortet. „unklar“ heißt: Die Paketlisten im + Gast sind alt. Der Homelab-Teil erneuert sie jede Nacht selbst, sobald sie älter als eine Woche sind; mit dem + kleinen Pfeil daneben geht es sofort. + +## Homelab · Updates + +- **Die offenen Updates**, eine Zeile je Update: Gerät, was läuft, was neu ist, der Rückweg und der Knopf. Jeder Knopf + fragt vorher und sagt, was passiert. Vorher wird ein Snapshot angelegt (beim Proxmox Backup Server eine + Sicherung); danach prüft der Orchestrator, ob das Gerät wieder antwortet. Ist die Prüfung rot, geht es von selbst + zurück, und du bekommst eine Nachricht. +- **Ohne Knopf** steht der Grund in der Zeile: Manche Apps (AdGuard, PVE Scripts Local, Arcane) aktualisieren sich + über ihre eigene Oberfläche. Wurde das Update-Skript einer App gerade erst geändert, wartet der Knopf zur + Sicherheit 48 Stunden; die Zeile sagt, ab wann. +- **Der Proxmox-Host** hat keinen Rückweg: Seine Pakete kommen mit Warnung, neu gestartet wird getrennt. +- **Verlauf:** die letzten Updates im Homelab mit Ergebnis. + ## Dienste und Protokolle Die Liste aller Dienste der Box: grün = läuft, rot = antwortet nicht, grau = schläft (bewusst abgeschaltet). @@ -116,7 +148,7 @@ Commander. Heute Nacht gab es …"). Sofort kommen nachts nur dringende Nachrich | „[Box-Update] Neustart steht an … Wartungsfenster (…)" | ein Neustart wartet auf das Wartungsfenster (ab Werk Sonntag früh) | nichts | | „[Box-Update] Die Box startet jetzt neu …" | geplanter Neustart im Wartungsfenster | nichts; sie ist ein paar Minuten weg | | „[Box-Update] Sonntags-Update mit Fehler beendet" oder „Auto-Update abgebrochen" | der Update-Lauf selbst ist abgebrochen, nichts wurde eingespielt | Seite Updates ansehen, Hilfe holen | -| „[Box-Problem] …" | der Wächter hat etwas Rotes gefunden | Startseite öffnen, in der Checkliste den Knopf drücken | +| „[Box-Problem] …" | der Wächter hat etwas Rotes gefunden | Cockpit der KI-Box öffnen, in der Checkliste den Knopf drücken | | „[Box wieder ok] Erledigt: …" | das Problem ist weg | nichts | | „[Modell-Radar] … hat den Nachttest bestanden" | ein besseres Modell wartet | Seite Modelle: „Übernehmen" oder „Verwerfen" | | „[Stack-Radar] …" (samstags) | Wochenbericht über die Box und Neuigkeiten | lesen |