mission-control-v2/docs/BEDIENUNG.md

# 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 in einem Cockpit etwas gelb oder rot leuchtet. Updates im Homelab spielst du selbst
per Knopf ein.

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 (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:

- **Ü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. 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.

## KI-Box · Cockpit

- **Große Leuchte oben links:**
  - grün „Alles in Ordnung": nichts zu tun;
  - gelb „Achtung" mit der Zahl der Hinweise: bei Gelegenheit ansehen;
  - rot „Störung": jetzt ansehen;
  - blau „Update läuft": die Box aktualisiert sich gerade, Hinweise ruhen bis zum Ende;
  - grau „Wächter schweigt": der Aufpasser der Box hat sich seit über 5 Minuten nicht gemeldet.
  Ein Klick auf die gelbe oder rote Leuchte springt zur Checkliste.
- **Warnlampen:** Motor (die Software, die die KI-Modelle rechnet), Hirn (Lucys Modell), Coder (das Modell zum
  Programmieren; „auf Abruf" ist normal), Hermes (Lucys Agent), Jobs, Sicherung (gelb, wenn die letzte älter als
  36 Stunden ist), Platte (gelb ab 80 %, rot ab 90 %), Updates.
- **Instrumente:** Speicher, Temperatur, Platte und die Zeit seit dem letzten Neustart.
- **Checkliste:** alles, was der Wächter gefunden hat. „Jetzt" heißt sofort ansehen, „Prüfen" heißt bei Gelegenheit.
  Unter jedem Punkt stehen Knöpfe, zum Beispiel „Neu starten", „Protokoll" (was der Dienst zuletzt geschrieben hat),
  „Erneut ausführen", „Freigeben" oder „Ausblenden bis zum nächsten Lauf". Einen abgestürzten Dienst startet die Box
  meist schon selbst neu.
- **Flugplan:** was heute schon lief und was als Nächstes kommt, etwa Sicherung, Modell-Radar, Morgenmeldung und die
  Updates am Sonntag.
- **Radar-Kasten:** ob das Modell-Radar gerade einen Kandidaten hat; „Ansehen" führt zur Seite Modelle.

## 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.
- Einmal pro Woche aktualisiert sich die Box von selbst, ab Werk sonntags um 04:30 (verschieben lässt es sich unter
  Einstellungen → Update-Zeitfenster); vorher sichert sie, danach prüft sie. Du musst nichts tun.
- „Nach Neuem suchen" schaut sofort nach. „Aktualisieren" spielt einen Baustein sofort ein, „Alles jetzt
  aktualisieren" alle nacheinander. Lucy ist dabei ein paar Minuten nicht erreichbar.
- **Festgehalten:** Ging ein Update schief, hat die Box die alte Version zurückgeholt und hält den Baustein fest. Sie
  läuft stabil weiter, bekommt für diesen Baustein aber keine Updates mehr. „Freigeben" heißt: am nächsten Sonntag
  noch einmal versuchen.
- **Prüfung unklar:** Die Box konnte nicht nachsehen, zum Beispiel ohne Internet. Später „Nach Neuem suchen" drücken.
- **Verlauf:** was die letzten Update-Läufe gebracht haben, je Baustein.
- **Sicherungen:** täglich gegen 03:30, mit Kopie auf einem zweiten Gerät. „Jetzt sichern" macht sofort eine.
  „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.

## 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):
  welches Modell die Rolle hat, ob es gerade geladen ist und ob es Bilder versteht. „Jetzt laden" lädt es vorab. Die
  „Dritte Rolle" bleibt frei, bis ein Modell dort nachweislich etwas bringt.
- **Wer nutzt die Modelle:** Anfragen der letzten 7 Tage je Absender und je Stunde.
- **Modell-Radar:** Die Box sucht selbst nach besseren Modellen und testet nachts zwischen 00:30 und 02:30 höchstens
  eines pro Woche. „Bestanden" heißt: besser als das heutige Modell. Dann entscheidest du:
  - „Übernehmen" tauscht das Modell. Beim Hirn ist Lucy etwa eine Minute weg; das alte Modell bleibt auf der Platte.
  - „Verwerfen" löscht die Dateien, und das Radar testet dieses Modell nie wieder.
  - „Jetzt suchen" sucht sofort (das kann ein paar Minuten dauern).
- **Weitere Einträge:** alle übrigen Modelle. „Modelle selbst suchen" findet Modelle auf Hugging Face und lädt sie.
- **Aufräumen:** Modelle und Ordner, die gerade niemand nutzt, mit Größe und Hinweis. Die Box löscht nie von selbst.
  „Löschen" ist endgültig; zurück ginge es nur mit einem neuen Download.
- **Altreste neben dem Betrieb** (unten im Aufräumen): Test-Ordner, alte Umgebungen, alte Arbeitskopien und
  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
  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:** 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.
- **Speicher und Sicherungen** (seit 25.09.): der Speicherpool des Proxmox-Hosts (auf ihm liegen alle Container, die
  VM und die Snapshots), das NAS (antwortet es, ist es eingebunden, wie voll) und die nächtlichen Sicherungen (hat
  jedes Gerät eine frische). Füllstände ab 80 % bernstein, ab 90 % — also bei 10 % frei — rot und als dringende
  Meldung. Darunter „Was im Speicherpool Platz bringt“: Vorschläge mit ungefährem Gewinn und dem Klickweg in
  Proxmox, größter zuerst; aufgeklappt, sobald der Pool knapp wird. Gelöscht wird nichts von selbst.

## Homelab · Updates

- **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).
„Protokoll" zeigt, was der Dienst zuletzt geschrieben hat. „Neu starten" startet ihn neu; „Wecken" weckt einen
schlafenden Dienst bis zum nächsten Neustart der Box. Die Spracherkennung und die Konsole schlafen seit 24.09. mit
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. Einen Snapshot der Arcane-VM vorher (und den Weg zurück bei Rot) gibt es nur,
  wenn die VM in Proxmox das Etikett `watcher` trägt; sonst steht in der Update-Liste „Kein automatischer Rückweg“.
- **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
  Homelab-Teil. Sie geht über denselben Weg wie jede echte Meldung und als dringend, kommt also auch nachts sofort.
  Darunter steht, ob sie raus ist (über Hermes oder direkt an Telegram) oder warum nicht, etwa „Zugangsdatei fehlt"
  oder „Telegram lehnt ab". Höchstens ein Test alle 20 Sekunden.
- **Update-Zeitfenster:** an welchem Wochentag und um welche Uhrzeit sich die Box aktualisiert (ab Werk Sonntag
  04:30), dazu der nächste Lauf. Neu starten darf sie sich danach nur in den drei Stunden ab der vollen Stunde, also
  ab Werk Sonntag 04:00–06:59. Am besten nachts nach der Sicherung (03:30) und vor der Morgenmeldung (07:00).
  „Speichern" fragt nach. Ein Termin, der dadurch schon vorbei wäre, wird nicht nachgeholt; der erste Lauf ist der
  nächste reguläre. Während eines Update-Laufs lässt sich das Fenster nicht ändern.
- **Modell-Radar:** ob das Radar nachts nach besseren Modellen sucht. „Ausschalten" legt es schlafen, bis du es
  wieder einschaltest; auch ein Deploy weckt es nicht. Ein Nachttest, der gerade läuft, endet noch. „Einschalten"
  holt keinen verpassten Lauf nach, tagsüber lädt es also nichts.
- **Software-Stand:** welche Version des Orchestrators auf der KI-Box und im Homelab-Teil läuft und seit wann. Laufen
  beide mit verschiedenen Ständen, steht ein Hinweis darunter; der nächste Deploy der Box zieht den Homelab-Teil mit.
- **Hermes-Dashboard:** öffnet die eigene Oberfläche von Hermes (Chat, Sitzungen, Cron-Jobs). Hermes fragt nach
  seiner eigenen Anmeldung.

## Nachrichten auf Telegram

Nachts zwischen 0 und 7 Uhr sammelt die Box alles und schickt es um 7 Uhr als eine Nachricht („Guten Morgen,
Commander. Heute Nacht gab es …"). Sofort kommen nachts nur dringende Nachrichten.

| Nachricht | Bedeutung | Was du tust |
|---|---|---|
| „[Morgenmeldung] Guten Morgen, Commander …" | alles aus der Nacht in einer Nachricht | lesen |
| „[Box-Update] … aktualisiert … alles läuft" | Update eingespielt und geprüft | nichts |
| „[Box-Update] Commander, die Wochenpflege der Box ist durch" | Sonntagsbericht, eine Zeile je Baustein | lesen |
| „[Box-Update] … fehlgeschlagen … zurückgerollt … GEPINNT" | Update ging schief, die alte Version läuft wieder, der Baustein ist festgehalten | nichts nötig; bei Gelegenheit unter Updates „Freigeben" |
| „[Box-Update] KRITISCH: …" (sofort, auch nachts) | Update und Rückweg sind gescheitert | Box ansehen (unten), Hilfe holen |
| „[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 | 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 |
| Daily News (07:00, Text und Sprachnachricht) | die Nachrichten des Tages von Lucy | lesen oder hören |
| „[Alarm] Deploy …" (sofort) | eine neue Version des Box-Warts ließ sich nicht einspielen, die alte läuft wieder | nichts sofort; Bescheid geben |
| „[Test] Testmeldung aus den Einstellungen …" (sofort) | du hast unter Einstellungen „Test senden" gedrückt | nichts; der Meldeweg funktioniert |

## Wenn etwas hakt

- **Die Seite lädt nicht:** die Box einmal mit dem Knopf am Gerät neu starten, 2–3 Minuten warten, die Seite neu
  laden. Hilft das nicht: Hilfe holen (für Techniker: [BETRIEB.md](BETRIEB.md), Abschnitt „Notfall").
- **Die Leuchte ist rot:** in der Checkliste den ersten Knopf drücken, meist „Neu starten". Nach einer Minute prüft
  der Wächter erneut.
- **Lucy antwortet nicht:** die Lampen Hirn und Hermes ansehen; unter „Dienste und Protokolle" Hermes neu starten.
- **Ein Baustein bleibt festgehalten:** unter Updates „Freigeben".