Eine verfügbare vollständige Version wählen
Öffne Mein One-Home und gehe zu Downloads. Dort erscheinen offizielle Stable-Versionen, für die dein Konto Downloadrechte besitzt. Lies Version, Veröffentlichungsdatum und Versionshinweise und vergleiche sie mit der Core-Version deiner Installation. Eine neue Nummer in einer Demo oder auf der Website bedeutet nicht, dass das Paket bereits verfügbar ist.
Für Backend und Hausverwaltung brauchst du das vollständige Core-Paket. Bei v0.37 heißt es One-Home-Core-v0.37.0-Lichtgroepen.zip. One-Home-v0.37.0-Lichtgroepen.zip enthält die Oberfläche für einen Theme-Tester oder eine Entwicklungswebsite und installiert allein kein Backend.
Die bestehende Installation vorbereiten
Der folgende Befehl gehört zur bestehenden Standardinstallation mit /home/onehome/.env und /home/onehome/data. Folge bei einem anderen Aufbau den Installationsabsprachen deines Administrators. Lies immer die Installationsanleitung der Version, die du tatsächlich verwenden wirst.
Wähle einen passenden Zeitpunkt: Während der Umschaltung kann die Hausoberfläche kurz nicht erreichbar sein. Bewahre aktuelle Installationsidentität, Datenbank, Konfiguration und Verschlüsselungsschlüssel gemeinsam auf. Ein neuer Schlüssel löst kein Problem mit vorhandenen verschlüsselten Verbindungen.
- Notiere die aktuelle Core-Version und die übliche Zugriffsadresse.
- Prüfe, ob eine brauchbare Sicherung und die zugehörigen Wiederherstellungsinformationen verfügbar sind.
- Prüfe den freien Speicher. Der Updater von v0.37.0 verlangt mindestens 2 GiB freien Platz.
- Entpacke die vollständige Core-ZIP in ein neues Versionsverzeichnis auf Core und behalte zentrale Konfiguration und Datenverzeichnis bei.
Den dokumentierten Updatevorgang ausführen
Führe im entpackten Versionsverzeichnis aus: bash scripts/update-onehome.sh. Dieser Befehl ist für den Administrator mit Zugriff auf die Standardinstallation bestimmt. Führe ihn nicht in einem Verzeichnis aus, das nur eine Website oder ein Oberflächenpaket enthält.
Das Skript erstellt eine Wiederherstellungskopie, bewahrt die vorhandene Datenbank und relevante Konfiguration und baut den neuen Core. Beim Bauen bleibt der bisherige Container aktiv; danach folgen Umschaltung und Prüfungen. Unterbrich das laufende Update nicht. Bewahre Abschlussausgabe und gemeldeten Sicherungspfad auf.
Mehr als die Versionsnummer prüfen
Öffne danach deine übliche Core-Adresse mit /app/ und melde dich mit dem bestehenden Konto an. Zur praktischen Updateprüfung gehören eigene Hausdaten und echte Gerätebedienung. Ein laufender Prozess oder sichtbarer Startbildschirm reicht dafür nicht aus.
- Prüfe die gemeldete Core-Version und öffne bestehende Räume.
- Prüfe One-Links, erkennbare Gerätenamen und Raumzuordnungen.
- Teste ein echtes Gerät und warte auf den bestätigten Zustand. Teste bei Lichtgruppen auch eine Gruppe mit mehreren Lampen.
- Prüfe einen zweiten Bildschirm und ein Konto mit Leserechten. Hausdaten sollten übereinstimmen, während Bildschirmeinstellungen getrennt bleiben können.
- Prüfe später in Mein One-Home, ob letzter Kontakt und bestätigter Versionswechsel aktualisiert wurden.
Ein fehlgeschlagenes Update beurteilen
Notiere den genauen Fehler und die Stelle, an der das Update stoppte. Der Standardupdater enthält einen automatischen Rückweg bei fehlgeschlagener Umschaltung. Dabei können vorheriger Container, Datenbank und zentrale Konfiguration aus der Wiederherstellungskopie zurückgesetzt werden. Prüfe vor einem zweiten Versuch, was tatsächlich wieder läuft.
Ein fehlgeschlagener Build, zu wenig Speicher und ein Fehler nach der Umschaltung brauchen unterschiedliche Folgeschritte. Bewahre deshalb die Ausgabe auf. Lösche keine bestehende Datenbank, Schlüssel oder Verbindungen, um einen Startfehler zu verdecken. Lasse die manuelle Wiederherstellung mit nachweislich zur selben Installation gehörenden Bestandteilen durchführen.
Wiederherstellung und Nachkontrolle festhalten
Behalte die Wiederherstellungskopie, bis das Zuhause wieder normal funktioniert. Eine Browser-Layout-Sicherung ersetzt sie nicht: Sie enthält weder Core-Datenbank noch Bewohnerrechte. Eine Cloud-Sicherung kann zusätzlich den separat aufbewahrten Wiederherstellungsschlüssel benötigen.
Nutze für Hilfe Mein One-Home > Support und nenne vorherige und beabsichtigte Version, Fehlermeldung, Zeitpunkt und bereits durchgeführte Prüfungen. Teile keine .env-Datei oder geheimen Schlüssel. Notiere nach der Wiederherstellung die tatsächlich aktive Version und prüfe lokale Bedienung und Zugriffsrechte erneut.