Kurze Antwort
Wenn du Hermes Agent auf einem Heimserver ausführen möchtest, ohne Daten zu verlieren, solltest du dich nicht darauf verlassen, dass das interne Dateisystem des Containers der einzige Speicherort für Konfiguration, Skills, Protokolle, generierte Dateien oder Gateway-Einstellungen ist. Plane zuerst einen persistenten Host-Ordner oder ein Docker-Volume, binde es am tatsächlich von der App verwendeten Container-Pfad ein, überprüfe die Dateibesitzrechte und stelle sicher, dass die Daten nach einem Neustart oder einer Neukonfiguration noch vorhanden sind. Dieser Artikel behandelt das häufige Fehlerbild, bei dem ein Container einen Ordner aufgrund von Problemen mit Volume-Mounts, Berechtigungen oder der Pfadzuordnung nicht finden kann.
Der sicherste Ablauf für Einsteiger ist:
- Finde heraus, welche Hermes-Agent-Daten erhalten bleiben müssen.
- Wähle einen eigenen Host-Ordner oder ein von Docker verwaltetes Volume.
- Binde diesen Speicher am richtigen Container-Pfad ein.
- Stelle sicher, dass der App-Benutzer Schreibzugriff darauf hat.
- Sichere wichtige Konfigurationen vor Updates oder Neuaufbauten.
- Starte den Container neu und überprüfe, ob Konfiguration, Protokolle, generierte Dateien und Gateway-Einstellungen weiterhin vorhanden sind.
Ein laufender Container bedeutet nicht automatisch, dass deine Daten sicher sind. Daten sind nur dann sicher, wenn sie an einem persistenten Speicherort abgelegt, für den richtigen Benutzer beschreibbar, bei Bedarf gesichert und nach einem Neustart überprüft werden.
Warum Hermes-Agent-Daten in einer Container-Umgebung verschwinden können
Containerisierte Apps lassen sich oft leicht starten und ersetzen. Das ist für Updates, Tests und die Wiederherstellung praktisch, bedeutet aber auch, dass alles, was nur in der austauschbaren Container-Ebene gespeichert ist, beim Entfernen, Neuerstellen oder Neuaufbau des Containers verloren gehen kann.
Bei einem selbst gehosteten KI-Agenten kann mehr als nur die Grundeinstellungen betroffen sein. Je nachdem, wie du den Agenten verwendest, sind möglicherweise Modellkonfiguration, Skills, generierte Dateien, Protokolle, Einstellungen des Messaging-Gateways und andere App-Daten wichtig.
Container-Neustarts und persistente App-Daten
Ein normaler Neustart des Containers entfernt nicht immer Daten. Sind die Daten in einem persistenten Volume oder einem korrekt eingebundenen Host-Ordner gespeichert, sollten sie nach dem Neustart weiterhin verfügbar sein.
Das Risiko entsteht, wenn wichtige Dateien ausschließlich in der beschreibbaren Ebene des Containers liegen. Diese Ebene ist nicht dasselbe wie ein geplanter persistenter Speicherort. Wenn du den Container neu erstellst, ohne den richtigen Pfad zu sichern oder erneut einzubinden, startet die App möglicherweise mit einer leeren Konfiguration oder findet ihre bisherigen Dateien nicht.
Warum das Löschen oder Neuerstellen eines Containers ungespeicherte Daten entfernen kann
Einen Container zu löschen oder neu zu erstellen ist etwas anderes, als ihn neu zu starten. Ein neu erstellter Container kann ein neues internes Dateisystem, neue Umgebungsvariablen oder eine andere Mount-Zuordnung verwenden.
Wenn Einstellungen, Skills, Protokolle oder generierte Ausgaben von Hermes Agent nie in einem persistenten Host-Ordner oder Volume gespeichert wurden, werden sie möglicherweise nicht in den neuen Container übernommen. Deshalb können sowohl „Die App hat gestern noch funktioniert“ als auch „Nach dem Update wurde die App zurückgesetzt“ zutreffen.
Die sichere Faustregel lautet: Betrachte das Ersetzen eines Containers als Datenrisiko, solange du nicht überprüft hast, wo die App-Daten gespeichert sind.
Warum Host- und Containerpfade zuerst geplant werden müssen
Ein Hostpfad ist der Speicherort der Daten auf dem Home-Server. Ein Containerpfad ist der Ort, an dem die App diese Daten innerhalb des Containers sieht. Ein Volume- oder Bind-Mount verbindet diese beiden Welten.
Wenn der Hostpfad stimmt, aber dem falschen Containerpfad zugeordnet ist, kann sich die App weiterhin so verhalten, als gäbe es den Ordner nicht. Wenn der Containerpfad stimmt, der Hostpfad aber nur vorübergehend verfügbar ist, schreibt die App möglicherweise Daten an einen anderen Ort als vorgesehen.
Plane die Zuordnung, bevor du die App startest, nicht erst, nachdem Daten verloren gegangen sind.
Welche Daten solltest du schützen, bevor du Hermes Agent ausführst?
Bevor du einen Container änderst, ein Image aktualisierst oder ein Gateway neu konfigurierst, liste die Daten auf, deren Wiederherstellung mühsam wäre. Nicht jede Datei braucht denselben Schutz, aber du solltest wissen, welche Dateien kritisch sind.
Eine hilfreiche Faustregel: Schütze alles, was Identität, Zugriff, Konfiguration, erlernte Arbeitsabläufe oder Ausgaben speichert, die sich nicht ohne Weiteres neu erstellen lassen.
Agentenkonfiguration und Einstellungen des Modellanbieters
Zu den Modelleinstellungen gehören üblicherweise die Wahl des Anbieters, Endpunktwerte, Modellnamen, kontextbezogene Optionen und API-Zugriff. Gehen diese Einstellungen verloren, startet der Agent möglicherweise, kann aber nicht korrekt antworten.
Speichere die Modellkonfiguration in einem dauerhaften App-Datenpfad und nicht in einer flüchtigen Shell-Sitzung. Wenn die Konfiguration über Umgebungsvariablen bereitgestellt wird, bewahre eine sichere Kopie der Compose-Datei, der Env-Datei oder der Bereitstellungsnotizen auf.
Schütze auch alle Einrichtungseinstellungen, die festlegen, wie der Agent Terminal-Tools oder Messaging-Gateways verwendet.
App-Speicher, Sitzungen, Skills und Laufzeitstatus
Hermes-Agent-Daten können mehr als eine Konfigurationsdatei umfassen. Die Datenstruktur der Hermes-Skills erklärt, dass Skills unter ~/.hermes/skills/ gespeichert werden. Dieses Verzeichnis ist die maßgebliche Quelle für gebündelte, über den Hub installierte und vom Agenten erstellte Skills. Außerdem werden damit verbundene Zustände wie gebündelte Manifeste, Skill-Bundles, die Tap-Konfiguration des Hubs, ausstehende Skill-Schreibvorgänge und Konfigurationseinstellungen beschrieben.
Das ist wichtig, weil vom Agenten erstellte Skills zu wiederverwendbarem prozeduralem Wissen werden können. Wenn der falsche Pfad eingebunden ist, verlierst du womöglich nicht nur Einstellungen, sondern auch Arbeitsabläufe, die der Agent gelernt hat, oder Skills, die du installiert hast.
Behandle Skills, Bundles, ausstehende Schreibvorgänge und profilbezogene Zustände als dauerhafte Agentendaten.
Downloads, generierte Dateien, Protokolle und Tool-Ausgaben
Generierte Dateien übersieht man leicht. Ein Agent kann während der normalen Nutzung Pläne, Skripte, Berichte, Screenshots, Protokolle oder heruntergeladene Dateien erstellen.
Diese Dateien können im aktiven Arbeitsbereich, im Backend-Arbeitsverzeichnis, im App-Home-Verzeichnis oder an einem eingebundenen Ausgabepfad gespeichert werden. Befindet sich dieser Speicherort nur innerhalb des Containers, können die Dateien beim Entfernen des Containers verloren gehen.
Für die praktische Nutzung solltest du festlegen, wo generierte Dateien auf dem Host-Server erscheinen sollen, und überprüfen, ob der Container dort hineinschreibt.
API-Schlüssel, Bot-Tokens und Umgebungsvariablen
Geheimnisse sind keine gewöhnlichen App-Daten. API-Schlüssel, Bot-Tokens, Dashboard-Passwörter und Umgebungsvariablen müssen sowohl dauerhaft gespeichert als auch geschützt werden.
Speichere Geheimnisse nicht in zufälligen Ordnern mit generierten Ausgaben oder in allgemein zugänglichen Verzeichnissen. Bewahre sie in einem kontrollierten Konfigurationspfad mit eingeschränktem Zugriff auf.
Eine gute Lösung für den Umgang mit Geheimnissen sollte Folgendes klären:
- wo das Geheimnis gespeichert ist;
- welcher Benutzer es lesen kann;
- ob es in Backups enthalten ist;
- ob das Backup verschlüsselt oder zugriffsgeschützt ist;
- wie sich das Geheimnis ändern lässt, falls es offengelegt wird.
Host-Pfade, Container-Pfade und Volume-Mounts
Dies ist das Schlüsselkonzept hinter den meisten Problemen wie „Container kann Ordner nicht finden“ und „Daten nach Neustart verschwunden“. Ein Container kann nur auf das zugreifen, was in seinem eigenen Dateisystem vorhanden oder in ihn eingebunden ist.
Nutze Die Übersicht zum Erhalt von Agentendaten, um die Einrichtung vor der Fehlersuche zu strukturieren.
| Framework-Modul | Zentrale Frage | Was du damit entscheiden kannst | Schwerpunkt Einrichtung / Fehlerbehebung |
|---|---|---|---|
| Dateninventar | Welche Daten müssen einen Container-Neustart oder eine Neuerstellung überstehen? | Welche Konfigurationen, Skills, Protokolle, Downloads, Tokens und generierten Dateien geschützt werden müssen | Verhindert, dass wichtige Agentendaten als entbehrlicher Zustand behandelt werden |
| Speicherpfad für dauerhafte Daten | Wo sollten dauerhaft gespeicherte Daten auf dem Host liegen? | Ob ein eigener Host-Ordner, ein Docker-Volume oder ein Bind-Mount verwendet werden soll | Verhindert das Zurücksetzen von Daten nach dem Neuerstellen des Containers |
| Mount-Zuordnung | Ist der Host-Pfad korrekt auf den Container-Pfad gemappt? | Ob die App den vorgesehenen Ordner tatsächlich sehen kann | Hilft bei der Diagnose von Fehlern wegen fehlender Ordner und falscher Zielpfade |
| Berechtigungsgrenze | Welcher Benutzer Eigentümer der eingebundenen Daten ist und welcher Benutzer hineinschreibt | Ob der Host-Benutzer, Container-Benutzer, App-Benutzer oder Root-Benutzer Eigentümer der Dateien ist | Hilft bei der Behebung von Zugriffsverweigerungen, ohne alles dem Root-Benutzer zuzuweisen |
| Sicherungsumfang | Was sollte vor Updates oder einer Neukonfiguration gesichert werden? | Welche Daten kritisch und welche temporär sind | Verhindert den Verlust von Konfigurationen, Skills, Sitzungen, Tokens und Gateway-Einstellungen |
| Neustart-Validierung | Sind die Daten nach einem Neustart oder Update noch vorhanden? | Ob die Einrichtung tatsächlich dauerhaft ist | Macht aus „es läuft“ eine wiederholbare Sicherheitsprüfung |
Was der Host-Server speichert
Der Host-Server speichert die eigentlichen Ordner, Datenträger und von Docker verwalteten Speicherorte. Bei einem Bind-Mount wählst du einen bestimmten Host-Ordner aus. Bei einem benannten Docker-Volume wählt Docker den Speicherort aus und verwaltet ihn.
Diese Unterscheidung ist wichtig, weil sich die Sichtbarkeit auf dem Host auf Backups und Migrationen auswirkt. Ein als Bind-Mount eingebundener Ordner ist für Einsteiger möglicherweise leichter zu finden und zu kopieren. Ein benanntes Volume ist für von Docker verwaltete App-Daten möglicherweise übersichtlicher, aber du musst trotzdem wissen, wie du es überprüfst oder sicherst.
Wählen Sie den Speichertyp danach aus, ob Sie lesbare Host-Ordner, eine von Docker verwaltete dauerhafte Speicherung für Apps oder einen kontrollierten Sicherungspfad benötigen.
Was der Container sehen kann
Der Container sieht sein eigenes internes Dateisystem und alle eingebundenen Pfade. Er sieht nicht automatisch alle Ordner auf Ihrem Home-Server.
Docker zeigt in der Anleitung zu Bind-Mounts, wie ein Host-Verzeichnis unter einem Zielpfad im Container eingebunden werden kann und wie Dateiänderungen zwischen Host und Container übernommen werden, wenn die Einbindung korrekt eingerichtet ist.
Das ist der entscheidende Punkt: Der Speicherort einer Datei auf dem Host ist der App egal, solange sie nicht in den von der App verwendeten Pfad eingebunden ist.
Wie Volume-Einbindungen App-Daten dauerhaft speichern
Eine dauerhafte Einbindung bietet der App einen beständigen Speicherort, an dem sie auch über die Lebensdauer eines einzelnen Containers hinaus Daten ablegen kann. Bei App-Daten macht das oft den Unterschied zwischen „neustartsicher“ und „nur für die Lebensdauer des Containers“ aus.
Die Einbindung muss dem erwarteten Datenpfad der App entsprechen. Wenn die App in einen internen Ordner schreibt, Sie aber einen anderen Ordner einbinden, können die Daten weiterhin in einem temporären Speicher landen.
Eine gute dauerhafte Einrichtung sollte Folgendes festlegen:
- der Host-Ordner oder das benannte Volume;
- der Zielpfad im Container;
- ob die Einbindung Lese- und Schreibzugriff oder nur Lesezugriff erlaubt;
- welche App-Daten dort gespeichert werden;
- wie der Pfad gesichert wird.
Warum eine falsche Pfadzuordnung zu Fehlern wegen fehlender Ordner führt
Eine falsche Pfadzuordnung äußert sich oft so, als würde ein Ordner fehlen. Der Ordner kann auf dem Host vorhanden sein, aber für den Container unsichtbar sein. Oder im Container gibt es einen Ordner am erwarteten Pfad, der jedoch nicht mit dem vorgesehenen Host-Ordner verbunden ist.
Häufige Symptome sind:
- Die App meldet, dass ein Ordner nicht existiert;
- Generierte Dateien erscheinen im Container, aber nicht auf dem Host;
- Protokolle verschwinden, wenn der Container neu erstellt wird;
- Die Konfiguration wird nach einem Update zurückgesetzt;
- Sie bearbeiten einen Ordner auf dem Host, aber die App verwendet weiterhin die alten Einstellungen;
- Backup-Skripte laufen, sichern aber nicht die tatsächlichen App-Daten.
Prüfen Sie in diesem Fall gemeinsam den Host-Pfad und den Container-Pfad. Untersuchen Sie nicht nur eine der beiden Seiten.
Hermes Agent ausführen, ohne Daten zu verlieren
Es geht nicht nur darum, Hermes Agent zu starten. Sie sollten auch sicherstellen, dass die Daten, die Ihnen wichtig sind, Neustarts, Updates, den Neuaufbau und eine Neukonfiguration überstehen.
Schritt 1: Dedizierten Datenordner auf dem Host auswählen
Wählen Sie einen Datenordner auf dem Host aus, bevor Sie den Container ausführen oder neu erstellen. Er sollte leicht zu erkennen und zu sichern sein und keine nicht zugehörigen persönlichen Dateien enthalten.
Ein dedizierter Ordner senkt das Risiko, weil Sie sehen können, was zur App gehört. Außerdem müssen Sie so nicht Ihr gesamtes Home-Verzeichnis oder andere sensible Ordner in den Container einbinden.
Ein praktischer Datenordner auf dem Host sollte:
- spezifisch für die App;
- außerhalb temporärer Download-Verzeichnisse;
- in Ihrem Backup-Plan berücksichtigt;
- Nicht breit mit unbeteiligten Diensten geteilt;
- Nur beschreibbar für Benutzer oder Dienste, die Zugriff benötigen.
Schritt 2: Datenordner in den Container einbinden
Binde den Host-Datenordner in den Containerpfad ein, den die App erwartet. An diesem Punkt werden viele Datenverluste verursacht oder verhindert.
Bei einem Bind-Mount legst du den Host-Pfad fest; der Zielpfad ist der Ort, an dem er im Container erscheint. Bei einem benannten Volume verwaltet Docker den Speicherort auf dem Host.
Geh nicht davon aus, dass die App automatisch einen eingebundenen Ordner verwendet. Prüfe, ob der eingebundene Zielpfad mit dem tatsächlichen App-Datenpfad übereinstimmt.
Schritt 3: Sicherstellen, dass der Container den erwarteten App-Datenpfad verwendet
Prüfe nach dem Einbinden den Pfad im Container. Ein Ordner kann auf dem Host vorhanden und für die App dennoch unsichtbar sein, wenn er nicht korrekt eingebunden wurde.
Am einfachsten lässt sich das prüfen, indem du auf einer Seite eine harmlose Testdatei erstellst oder suchst und bestätigst, dass sie auf der anderen Seite erscheint. Prüfe anschließend, ob die App echte Konfigurationen, Protokolle oder generierte Dateien im selben dauerhaften Speicherpfad ablegt.
Dieser Schritt ist besonders vor Aktualisierungen oder einer Migration wichtig.
Schritt 4: Dateieigentümerschaft und Schreibberechtigungen prüfen
Auch ein korrekt eingebundener Mount kann fehlschlagen, wenn die App nicht darauf schreiben kann. Berechtigungsfehler treten häufig auf, wenn Dateien von Root erstellt werden, die App später aber unter einem anderen Benutzer läuft.
Prüfe die Eigentümerschaft, bevor du Berechtigungen weitreichend änderst. Meist besteht die richtige Lösung darin, dem vorgesehenen App-Benutzer Lese- und Schreibzugriff auf den jeweiligen App-Datenordner zu geben, statt allen Prozessen die vollständige Kontrolle über weitreichende Host-Verzeichnisse zu gewähren.
Wenn die Meldung „Zugriff verweigert“ erscheint, ermittle:
- der eingebundene Host-Pfad;
- der Zielpfad im Container;
- der Benutzer, unter dem die App läuft;
- der Dateieigentümer;
- ob der Mount schreibgeschützt ist;
- ob ein Backup- oder Exportpfad ebenfalls beschreibbar ist.
Schritt 5: Geheimnisse und Konfigurationsdateien außerhalb von Pfaden aufbewahren, die gelöscht werden können
Geheimnisse und Konfigurationsdateien sollten nicht ausschließlich in temporären Ordnern, Verzeichnissen für generierte Dateien oder der improvisierten Shell-History gespeichert werden. Wenn du Umgebungsvariablen verwendest, bewahre die Deployment- oder Env-Datei an einem kontrollierten, dauerhaften Speicherort auf.
Speichere Geheimnisse nicht zusammen mit Protokollen oder generierten Dateien. Protokolle können zur Fehlerbehebung geteilt werden, Geheimnisse sollten dagegen niemals leichtfertig weitergegeben werden.
Schütze Backups, wenn du darin Geheimnisse speicherst. Ein Backup, in dem API-Schlüssel oder Bot-Tokens offengelegt werden, birgt eine andere Art von Risiko.
Schritt 6: Container neu starten und prüfen, ob die Daten noch vorhanden sind
Starte nach dem Setup den Container neu und prüfe, ob die wichtigen Daten erhalten bleiben. Das ist der praktischste Test für die dauerhafte Speicherung.
Gib dich nicht damit zufrieden, dass „der Container startet“. Prüfe, ob:
- Modelleinstellungen weiterhin vorhanden sind;
- Skills oder der App-Status weiterhin sichtbar sind;
- Protokolle weiterhin am erwarteten Ort gespeichert werden;
- generierte Dateien auf dem Host erscheinen;
- Gateway- oder Bot-Einstellungen weiterhin funktionieren;
- Backupdateien auffindbar sind.
Ein Setup, das einen Neustarttest besteht, ist viel sicherer als eines, das nur bei der Erstinstallation funktioniert hat.
Berechtigungen, Backups und Sicherheitsgrenzen
Die Datensicherheit hängt von drei Grenzen ab: wer schreiben darf, welche Daten gesichert werden und worauf der Agent zugreifen darf. Diese Grenzen sind besonders wichtig bei selbst gehosteten Agenten, da sie Dateien erstellen, Abläufe ändern oder mit Tools interagieren können.
Warum die Berechtigungen des Container-Benutzers wichtig sind
Die Berechtigungen des Container-Benutzers bestimmen, ob die App ihre Daten lesen und schreiben kann. Wenn die App unter einem Benutzer läuft, der eingebundene Ordner aber einem anderen Benutzer gehört, können Schreibvorgänge fehlschlagen.
Deshalb kann ein als Root ausgeführter Setup-Befehl später Probleme verursachen. Root kann Dateien erfolgreich erstellen, doch der normale App-Benutzer kann sie möglicherweise nicht ändern.
Korrigiere die Berechtigungen auf Ebene des App-Datenordners. Vermeide umfassende Berechtigungsänderungen, durch die nicht zugehörige Host-Dateien offengelegt werden.
Warum du nicht alles als Root ausführen solltest
Root kann viele Einschränkungen umgehen, ist deshalb aber nicht automatisch eine sichere Standardeinstellung. Wenn alles als Root ausgeführt wird, können Dateien im Besitz von Root entstehen, Berechtigungsprobleme verborgen und der App mehr Zugriffsrechte eingeräumt werden, als sie benötigt.
Bei den meisten selbst gehosteten App-Abläufen sollte Root nur für bestimmte administrative Schritte verwendet werden. Die reguläre App-Konfiguration sollte nach Möglichkeit unter dem vorgesehenen App- oder Container-Benutzer ausgeführt werden.
Ein sichereres Vorgehen ist das Prinzip der geringsten Berechtigungen: Gib der App nur für die Ordner Schreibzugriff, die sie benötigt.
Wann du schreibgeschützte Mounts oder eingeschränkte Ordner verwenden solltest
Verwende schreibgeschützte Mounts, wenn der Agent Dateien untersuchen, sie aber nicht ändern soll. Verwende Ordner mit eingeschränktem Schreibzugriff, wenn der Agent Ausgaben erstellen, aber nicht auf allgemeine persönliche oder Systemverzeichnisse zugreifen soll.
Das ist besonders nützlich, wenn der Agent Berichte, Pläne oder Skripte erstellen soll, ohne Schreibzugriff auf alle Serverdateien zu erhalten.
Ein Design mit eingeschränktem Ordnerzugriff verringert die Auswirkungen von Fehlern. Außerdem lassen sich Backups leichter erstellen, weil du weißt, welcher Ordner den App-Status enthält und welcher Ordner die erzeugten Ausgaben.
So sicherst du Agent-Daten vor Updates oder einer Neukonfiguration
Sichere wichtige App-Daten, bevor du Container-Images, Mount-Pfade, Gateway-Einstellungen oder Profile änderst. Ein Backup ist nur dann nützlich, wenn du weißt, was es umfasst und wie du es wiederherstellst.
Die Diskussion in der Docker-Community über Berechtigungen beim Sichern von Volumes zeigt ein häufiges Problem aus Nutzersicht: Ein Pfad ist möglicherweise vorhanden, doch Sicherungs- oder Schreibvorgänge können aufgrund von Einschränkungen bei Berechtigungen, Besitzverhältnissen, Labels oder Mounts trotzdem fehlschlagen.
Nutze das als Erinnerung, Backups zu testen und nicht nur zu erstellen. Ein Backup-Plan sollte sowohl die Erstellung von Backups als auch die Überprüfung der Wiederherstellung umfassen.
Häufige Probleme und ihre Lösung
Wenn Hermes-Agent-Daten fehlen, installiere die App nicht sofort neu. Stelle zuerst fest, welche Ebene ausgefallen ist: Dateninventar, Persistenzpfad, Mount-Zuordnung, Berechtigungsgrenze, Backup-Grenze oder Neustartvalidierung.
Der Container kann einen eingebundenen Ordner nicht finden
Das bedeutet meist, dass der Pfad in einer Ebene vorhanden ist, in der anderen aber nicht. Der Host-Ordner ist möglicherweise nicht eingebunden, der Zielpfad im Container ist möglicherweise falsch oder die App sucht an einem anderen Ort.
Prüfe in dieser Reihenfolge:
- Bestätige, dass der Ordner auf dem Host vorhanden ist.
- Bestätige, dass der Container über den Mount verfügt.
- Bestätige den Zielpfad innerhalb des Containers.
- Bestätige, dass die App so konfiguriert ist, dass sie diesen Zielpfad verwendet.
- Bestätige, dass der App-Benutzer den Ordner lesen kann.
- Bestätige, dass der Mount nach Änderungen an den Compose- oder Ausführungseinstellungen erneut eingerichtet wurde.
Behebe das Problem nicht, indem du willkürlich Ordner im Container erstellst. Dadurch kann der Fehler vorübergehend verschwinden, während die Daten weiterhin in einem kurzlebigen Speicher liegen.
App-Daten werden nach einem Neustart zurückgesetzt
Wenn die Daten nach einem Neustart zurückgesetzt werden, schreibt die App möglicherweise in das interne Dateisystem des Containers statt in den persistenten Pfad. Möglicherweise verwendet sie auch ein anderes Profil, eine andere Umgebungsvariable oder ein anderes Datenverzeichnis als erwartet.
Prüfe, ob der Datenpfad vor und nach dem Neustart derselbe ist. Prüfe anschließend, ob der Ordner durch einen Mount eingebunden ist oder nur zur Container-Ebene gehört.
Wenn der Container neu erstellt wurde, bestätige, dass dasselbe Volume oder derselbe Bind-Mount mit dem neuen Container verknüpft wurde.
Fehler „Zugriff verweigert“ im Datenverzeichnis
„Zugriff verweigert“ bedeutet, dass die App den Pfad sehen, aber die erforderliche Aktion nicht ausführen kann. Ursache können die Besitzverhältnisse, schreibgeschützte Einbindungseinstellungen, Dateisystemlabels oder eine Abweichung zwischen Host-Benutzer und Container-Benutzer sein.
Beginne mit der einfachsten Prüfung: Kann der App-Benutzer eine harmlose Testdatei im Datenverzeichnis erstellen? Falls nicht, prüfe den Besitzer und die Berechtigungen dieses konkreten Pfads.
Vermeide es, das Problem durch umfassende Schreibrechte für das gesamte Host-Verzeichnis zu lösen. Korrigiere den Datenpfad der App und lege den vorgesehenen App-Benutzer fest.
Erzeugte Dateien werden nur im Container gespeichert
Wenn erzeugte Dateien nach einem Neuaufbau verschwinden, wurden sie wahrscheinlich im Container statt in einem eingebundenen Host-Pfad gespeichert. Das passiert häufig, wenn das Arbeitsverzeichnis oder das Ausgabeverzeichnis der App nicht eingebunden ist.
Lege fest, wo die erzeugten Dateien gespeichert werden sollen. Binde dann diesen Ausgabeordner ein oder konfiguriere die App so, dass sie einen vorhandenen persistenten Speicherort verwendet.
Erstelle nach dem Ändern des Pfads eine harmlose Testdatei und bestätige, dass sie auf dem Host erscheint.
Bot- oder Gateway-Einstellungen verschwinden nach der Neukonfiguration
Gateway-Einstellungen können verschwinden, wenn die Konfiguration an einem nicht persistenten Speicherort liegt oder die App nach einem Neustart mit einem anderen Profil ausgeführt wird. Dasselbe kann passieren, wenn eine Umgebungsvariable an einer Stelle geändert wird, der laufende Container aber einen anderen Wert verwendet.
Prüfe, ob die Gateway-Konfiguration, die Referenz auf das Bot-Token, die Zulassungsliste und die Dashboard-Einstellungen am erwarteten persistenten Speicherort gespeichert sind. Starte das Gateway anschließend neu und bestätige, dass die Einstellungen weiterhin aktiv sind.
Wenn der Bot vor dem Neustart funktioniert, danach aber nicht mehr, überprüfen Sie zuerst die Persistenz und die Umgebungskonfiguration, bevor Sie das Token ändern.
So prüfen Sie, ob Ihre Hermes-Agent-Daten sicher sind
Ein sicheres Setup sollte Neustart-, Schreib-, Sicherungs- und Zugriffstests bestehen. Diese Tests müssen nicht kompliziert sein, sollten aber nach größeren Änderungen wiederholt werden.
Konfiguration bleibt nach dem Neustart erhalten
Ändern Sie eine unkritische Einstellung, starten Sie den Container neu und prüfen Sie, ob die Einstellung erhalten bleibt. So stellen Sie sicher, dass die App auf persistentem Speicher schreibt.
Wenn die Einstellung verschwindet, fügen Sie nicht einfach weitere Konfigurationen hinzu. Beheben Sie zuerst den Datenpfad.
Protokolle und generierte Dateien erscheinen im erwarteten Host-Ordner
Protokolle und generierte Dateien sollten am erwarteten Speicherort auf dem Host erscheinen. Wenn sie nur im Container vorhanden sind, können sie beim Neuerstellen verloren gehen.
Überprüfen Sie beide Seiten des Mounts. Host und Container sollten dieselben relevanten Dateien sehen.
Der Agent kann ohne Berechtigungsfehler in App-Daten schreiben
Der Agent sollte als vorgesehener Benutzer in seinen App-Datenordner schreiben können. Ein erfolgreicher Schreibtest ist aussagekräftiger als die bloße Bestätigung, dass der Ordner existiert.
Achten Sie nach dem Neustart in den Protokollen auf Berechtigungsfehler. Manche Berechtigungsprobleme treten erst auf, wenn der Agent versucht, die Konfiguration zu aktualisieren, einen Skill zu schreiben, eine generierte Datei zu speichern oder den Gateway-Status zu aktualisieren.
Sicherungsdateien lassen sich finden und wiederherstellen
Eine Sicherung ist erst vollständig, wenn Sie sie finden und an einem Testort wiederherstellen können. Prüfen Sie zumindest, ob die Sicherung die Daten enthält, die Sie schützen wollten.
Stellen Sie bei wichtigen Setups die Sicherung in einem separaten Ordner oder einer Testinstanz wieder her, bevor Sie sich darauf verlassen. So entdecken Sie Probleme bei der Wiederherstellung nicht erst, nachdem Daten verloren gegangen sind.
Zugriff auf das Dashboard oder Nachrichten funktioniert nach dem Neustart weiterhin
Überprüfen Sie nach dem Neustart, ob der Zugriff auf das Dashboard oder die Nachrichten weiterhin funktioniert. So stellen Sie sicher, dass persistente Daten, Anmeldedaten, Gateway-Einstellungen und Netzwerkzugriff weiterhin aufeinander abgestimmt sind.
Wenn das Dashboard funktioniert, aber Nachrichten nicht zugestellt werden, überprüfen Sie die Gateway-Einstellungen und den Zugriff auf das Token. Wenn Nachrichten funktionieren, aber generierte Dateien verschwinden, überprüfen Sie den Ausgabepfad und die Mounts.
So funktioniert es in einer realen Heimserver-Umgebung
In einer realen Heimserver-Umgebung gilt dieselbe Logik zur Datensicherheit, auch wenn das System ein benutzerfreundliches Dashboard bereitstellt. Sie müssen weiterhin wissen, welche Daten erhalten bleiben müssen, wo sie gespeichert sind, wie der Container darauf zugreift, welcher Benutzer sie bearbeiten darf und wie Sie sie nach einem Neustart überprüfen.
Der ZimaOS-Hermes-Agent-Einrichtungsworkflow zeigt beispielsweise einen gerätespezifischen Ablauf, der die Konfiguration des Modellanbieters, die Einrichtung des Telegram-Gateways, den Zugriff auf den Hermes-Container, die Aktivierung der App-Umgebung, die Überprüfung des Web-Dashboards und die Behebung von Problemen mit Berechtigungen oder Bot-Antworten umfasst.
Für Nutzer, die Docker-Apps, Agenten-Workflows und lokale Dienste auf einem kompakten, ständig eingeschalteten Gerät betreiben, ist der ZimaBoard 2 Heimserver ein passendes Beispiel für eine leichtgewichtige Heimserverumgebung, in der persistente Ordner, Containerpfade, Berechtigungen und Speichererweiterungen gemeinsam geplant werden müssen. Es ist nicht die einzig mögliche Konfiguration, aber sie passt zu der Art von selbst gehostetem App-Workflow, um die es in diesem Leitfaden geht.
Die allgemeine Erkenntnis lässt sich auf andere Setups übertragen: Bevor du einem containerisierten Agenten wichtige Aufgaben anvertraust, solltest du sicherstellen, dass seine wichtigen Daten auch dann erhalten bleiben, wenn der derzeit laufende Container nicht mehr existiert.
Häufig gestellte Fragen
Warum sind meine Daten von Hermes Agent nach dem Neustart des Containers verschwunden?
Ein einfacher Neustart sollte keine persistenten Daten löschen, aber die App kann zurückgesetzt wirken, wenn sie in einen nicht persistenten Containerpfad geschrieben hat. Die Daten können auch fehlen, wenn der Container ohne dasselbe Volume oder denselben Bind-Mount neu erstellt wurde. Überprüfe den Hostpfad, den Containerpfad und den tatsächlichen App-Datenpfad, bevor du weitere Einstellungen änderst.
Was ist der Unterschied zwischen einem Docker-Volume und einem Bind-Mount?
Ein Docker-Volume wird von Docker verwaltet, während ein Bind-Mount einen von dir gewählten Host-Ordner in den Container einbindet. Ein Volume eignet sich oft gut für von der App verwaltete Daten, während sich ein Bind-Mount auf dem Host leichter direkt finden lässt. Die beste Wahl hängt davon ab, ob du von Docker verwalteten Speicher oder einen sichtbaren Host-Ordner für Backups und Überprüfungen möchtest.
Wo sollte ich App-Daten von Hermes Agent auf einem Heimserver speichern?
Verwende einen eigens dafür vorgesehenen persistenten Ordner oder ein Docker-Volume statt eines temporären Containerpfads. Der Speicherort sollte sich leicht sichern lassen, auf den Bedarf der App beschränkt sein und keine anderen sensiblen Dateien enthalten. Am wichtigsten ist, dass der von der App erwartete Containerpfad tatsächlich auf diesen persistenten Speicher verweist.
Warum meldet der Container, dass ein Ordner nicht existiert?
Der Ordner ist möglicherweise auf dem Host vorhanden, aber nicht im Container. Das bedeutet meist, dass der Mount nicht eingerichtet wurde, der Quellpfad falsch ist, der Zielpfad nicht stimmt oder die App in einem anderen Containerpfad sucht. Überprüfe sowohl die Host- als auch die Containerseite, statt unüberlegt einen neuen Ordner anzulegen.
Sollte ich Hermes Agent als Root ausführen, um Berechtigungsfehler zu vermeiden?
Die Ausführung als Root kann den unmittelbaren Fehler zwar umgehen, aber sie kann Dateien erzeugen, die Root gehören, und das Risiko erhöhen. Sicherer ist es, dem vorgesehenen App-Benutzer nur für den erforderlichen App-Datenpfad Lese- und Schreibrechte zu geben. Verwende Root nur für bestimmte administrative Aufgaben oder Reparaturen, wenn du die Änderung nachvollziehen kannst.
Wie oft sollte ich Daten von Hermes Agent sichern?
Sichere deine Daten, bevor du Updates durchführst, Container neu erstellst, Pfade änderst, das Gateway neu konfigurierst oder auf einen anderen Server umziehst. Bei aktiver Nutzung solltest du regelmäßige Backups einplanen, abhängig davon, wie häufig sich Skills, Einstellungen, generierte Dateien oder Sitzungen ändern. Ein Backup ist erst dann zuverlässig, wenn du überprüft hast, dass sich die Dateien finden und wiederherstellen lassen.
Support und Tipps
Mehr zum Lesen

Was vor dem Laden eines Community-Modells in Transformers zu beachten ist
Nutze das Transformers-Jinja-Sandbox-Update, um die Herkunft des Modells, Chat-Vorlagen, Remote-Code, serialisierte Gewichte und isolierte erste Ausführungen zu überprüfen.

Mirage lokal ausführen: OCR und Objekterkennung aus einem einzigen Bild
Testen Sie das kleine lokale Vision-Modell von Cactus Compute, überprüfen Sie die OCR- und Objektextraktion anhand realer Eingaben und verstehen Sie die Grenzen in...

So planst du einen Coding-Agenten in Open WebUI auf einem Homeserver ein
Richte in Open WebUI eine Coding-Agent-Automatisierung im Nur-Bericht-Modus ein, wähle ihr Terminal und ihren Arbeitsbereich aus und überprüfe Berechtigungen, Protokolle und die Wiederherstellung nach...



