diff --git a/docs/BEDIENUNG.md b/docs/BEDIENUNG.md index efd5e43..7c4ad6e 100644 --- a/docs/BEDIENUNG.md +++ b/docs/BEDIENUNG.md @@ -15,12 +15,24 @@ Im Heimnetz im Browser `http://192.168.178.151:9001` öffnen (oder den Homelab-T `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**. +- **Übersicht** — die Startseite, alles auf einen Blick. +- **KI-Box** (Indigo): **Cockpit**, **Updates**, **Modelle**, **Monitoring**, dazu **Dienste und Protokolle** und + das Hermes-Dashboard. +- **Homelab** (Violett): **Cockpit**, **Updates**, **Monitoring**, **Protokoll**. - Ganz unten die **Einstellungen**. -Jeder Bereich zeigt oben, ob er online ist, und neben „Updates“ die Zahl der Updates, die bereitstehen. +Jeder Bereich zeigt oben, ob er online ist, und neben „Updates“ die Zahl der Updates, die bereitstehen. Frühere +Adressen wie `/updates` und `/modelle` leiten auf die neuen weiter. + +## Übersicht + +- **Gesamtlage** oben: ein Satz, wie es steht („Alles läuft“, „1 Hinweis“, „Störung“), dazu vier Zahlen — Updates + bereit (je Bereich), Hinweise, Geräte online und was als Nächstes läuft. +- **Je Bereich eine Karte:** Messwerte der letzten Stunde (KI-Box: CPU, Speicher, Temperatur, Platte; Homelab: + dasselbe für den Proxmox-Host), darunter **wer welche Updates hat** — eine Zeile je Gerät, z. B. „NetBird · + App → 0.79.0 (ab 26.09. 08:06) · 48 Pakete“ — und die Hinweise. Ein Klick auf den Kopf führt ins Cockpit, ein + Klick auf eine Update-Zeile zur Updates-Seite des Bereichs. +- **Als Nächstes** (die geplanten Läufe) und **Zuletzt eingespielt** (die letzten Updates beider Bereiche). Wichtige Knöpfe fragen vorher nach. Was du auslöst, bestätigt eine kurze Meldung unten rechts. @@ -81,6 +93,12 @@ 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. +## KI-Box · Monitoring + +Oben der Zeitraum (1 Stunde, 24 Stunden, 7 Tage), darunter die Zahlen live und die Verläufe: CPU, Speicher, GPU, +Temperatur von CPU und GPU, Netz und Tokens pro Minute. Mit der Maus (oder den Pfeiltasten) zeigt ein Fadenkreuz die +Werte zu jedem Zeitpunkt; „Werte als Tabelle“ klappt die letzten Punkte als Zahlen auf. + ## Homelab · Cockpit - **Große Leuchte oben links:** grün „Alles aktuell“; cyan mit der Zahl der Updates, die bereitstehen (drücken führt @@ -89,23 +107,39 @@ Wichtige Knöpfe fragen vorher nach. Was du auslöst, bestätigt eine kurze Meld - **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, wie voll die Platte ist (ab 80 % bernstein, ab 90 % rot) 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. +- **Geräte:** wie es jedem Gerät geht — Netz, CPU, Speicher, Platte (ab 80 % bernstein, ab 90 % rot) und wie lange + es schon läuft. Probleme stehen oben. Ein Klick auf den Namen öffnet das Gerät im Monitoring. ## 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 +- **Eine Zeile je Gerät:** die App-Version (was läuft → was neu ist), die Pakete (Zahl offener Pakete, „aktuell“ oder + „unklar“ mit dem Alter der Paketlisten; die Lupe sucht sofort neu), der Rückweg und die Knöpfe („App updaten“, + „Pakete einspielen“). Oben, was sich jetzt einspielen lässt; darunter, was wartet; zuletzt, was aktuell ist. + 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. +- **Alle aktualisieren:** spielt alle Updates mit Knopf nacheinander ein. Die Rückfrage zeigt die Reihenfolge mit + Rückweg je Schritt: erst die übrigen Container, dann NPMplus und AdGuard (von ihnen hängt das Netz ab), ganz zum + Schluss der Proxmox-Host — neu gestartet wird er nicht. Ist eine Prüfung rot, geht dieser Schritt zurück und der Rest + bleibt stehen. Während des Laufs zeigt ein Kasten jeden Schritt mit Zustand; am Ende kommt eine Nachricht. - **Verlauf:** die letzten Updates im Homelab mit Ergebnis. +## Homelab · Monitoring + +Wie beim Monitoring der KI-Box: Zeitraum oben, darunter der Proxmox-Host (CPU, Speicher, Temperatur, Systemplatte, +Netz) und für jeden Gast CPU und Speicher. Die Werte kommen jede Minute vom Ausführer auf dem Proxmox-Host. + +## Homelab · Protokoll + +Was der Homelab-Teil getan hat, neueste zuerst und nach Tagen: Aufträge an den Ausführer (Snapshot, Update, Suche …), +Update-Läufe, Hinweise des Wächters, gesendete Meldungen und die nächtliche Paketsuche. Oben filterst du nach Art; +„Berichte zeigen“ blendet auch die Berichte ein, die alle zehn Minuten kommen. „Ausgabe zeigen“ klappt die Ausgabe +eines Auftrags auf. + ## Dienste und Protokolle Die Liste aller Dienste der Box: grün = läuft, rot = antwortet nicht, grau = schläft (bewusst abgeschaltet). @@ -115,6 +149,15 @@ Absicht; die Android-App wird sie später wieder brauchen. ## Einstellungen +Eine eigene Seite mit vier Karten: KI-Box, Homelab, Meldungen, Software-Stand. + +- **Arcane-API-Schlüssel (Homelab):** in Arcane unter Einstellungen → API-Schlüssel anlegen und hier einfügen. „Prüfen + und speichern“ fragt Arcane zuerst, ob der Schlüssel gilt; erst dann wird er gespeichert — im Homelab-Teil, nicht + auf der KI-Box — und nie wieder angezeigt. Danach sieht der Orchestrator, welche Docker-Images neuer sind. +- **Docker-Updates (Homelab):** ab Werk nur ein Probelauf (Arcane zeigt, was es täte). „Echt schalten“ fragt nach und + lässt sich jederzeit zurückschalten. +- **Ausführer und Updates (Homelab):** ob der Ausführer auf dem Proxmox-Host verbunden ist, in welchem Modus, wohin + Sicherungen gehen und wie lange nach einer Änderung am Update-Skript einer App gewartet wird. - **Hugging-Face-Zugang:** nötig für gesperrte Modelle und für schnellere Downloads. Eintragen, speichern, bei Bedarf löschen. - **Meldungen:** „Test senden" schickt eine kurze Testmeldung an Telegram, je einen Knopf für die KI-Box und für den