Table of contents
SQLite
Version: 2.0.0 Gültigkeit: produktive lokale Datenhaltung Letzter Stand: 4. Juli 2026
Die App verwendet Entity Framework Core 8 mit einer lokalen SQLite-Datei. Im Standardbetrieb liegt sie unter %LOCALAPPDATA%\Bastelhof\HomelabManager\homelab.db, im Portable-Modus unter <App-Ordner>\data\homelab.db.
Inhalt
Persistiert werden NetworkProfile, NetworkSegment, Device, NetworkInterface, IpAddressEntry, ServiceEntry, BackupJob, AppSetting, DocumentationExport, ChangeLogEntry, PluginRegistration, AutomationRule, AutomationRun und AgentRegistration.
Integritätsregeln umfassen eindeutige Profile, Dienste, IP- und MAC-Adressen, eindeutige Segmentnamen je Profil und Ports zwischen 1 und 65535. Entitäten besitzen GUIDs und UTC-Zeitstempel.
Migrationen werden beim Anwendungsstart angewendet. Datenzugriff erfolgt über Repositories und Unit of Work.
Der Portable-Modus wird ausschließlich durch portable.mode im App-Ordner aktiviert. Beide Modi verwenden dasselbe Schema und dieselben Integritätsregeln.
PluginRegistration hält Pakethash, Vertrauenshash und Aktivierungsstatus. AutomationRule definiert Auslöser und Aktion; zugehörige AutomationRun-Einträge werden beim Löschen der Regel mit entfernt. AgentRegistration enthält nur nicht sensible Verbindungs- und Statusdaten. Die Migration AddPluginAutomationAgents führt diese Tabellen ein.
Hinweise
Connector- und Agent-Geheimnisse sowie Sitzungstokens gehören nicht in SQLite und werden nicht mit dem Portable-Ordner übertragen. Vor manuellen Dateioperationen muss die App beendet werden; eine Sicherung sollte konsistent den gesamten data-Ordner einschließlich temporärer SQLite-Dateien umfassen.