Een checklist voor een veilige migratie van Home Assistant naar een nieuwe homeserver

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Een veilige migratie van Home Assistant is niet voltooid wanneer de nieuwe server het inlogscherm bereikt. De nieuwe host moet dezelfde configuratie, radio's, integraties, opslagpaden, netwerkidentiteit en lokaal bedieningsgedrag herstellen voordat de oude server buiten gebruik wordt gesteld.

Behandel de verhuizing als een hersteltest, waarbij nog steeds een terugrolkopie beschikbaar is. Maak een nieuwe back-up, noteer de afhankelijkheden van de oude server, herstel op het doelapparaat, verbind radio's en netwerkopslag opnieuw, test kritieke automatiseringen en houd de bron uitgeschakeld maar intact totdat de nieuwe installatie normaal gebruik en een herstart heeft doorstaan.

Maak een nieuwe volledige back-up en bewaar de herstelsleutel buiten de oude host

De huidige back-upworkflow van Home Assistant ondersteunt migratie tijdens de installatie, ook tussen verschillende apparaattypen. Controleer voordat je begint of het doelapparaat voldoende opslagruimte heeft, download de back-up of bewaar deze op een andere manier en houd de noodkit die nodig is om de back-up te ontsleutelen uit de buurt van de machine die wordt vervangen.

De huidige migratieprocedure van Home Assistant gebruikt tijdens de installatie op het nieuwe apparaat een back-up van het oude apparaat en vermeldt expliciet dat netwerkopslag en radiomigratie mogelijk nog aanvullende werkzaamheden vereisen.

Overschrijf de enige back-up niet tijdens de verhuizing. Bewaar minstens één kopie die onafhankelijk is van beide servers, zodat een defecte doelschijf of een onbedoelde reset niet zowel de herstelbron als de broninstallatie kan verwijderen.

Noteer de afhankelijkheden die niet fysiek met een back-up worden verplaatst

Een back-up kan de status van Home Assistant bewaren, maar kan geen USB-Zigbee- of Z-Wave-stick, netwerkkabel, UPS-aansluiting, externe databasehost, MQTT-broker, reverse proxy, NAS-share of routerreservering fysiek verplaatsen. Noteer deze afhankelijkheden voordat je de oude host uitschakelt.

Noteer het oude Home Assistant-IP-adres of de hostnaam, de externe URL, mounts voor netwerkopslag, de database-URL als Recorder extern draait, het brokeradres, USB-apparaten, radiotypen en eventuele hostspecifieke Compose- of VM-instellingen. Met deze inventaris kun je onderscheid maken tussen een mislukte herstelactie en een ontbrekende externe afhankelijkheid.

De bredere migratiechecklist van ZimaSpace volgt dezelfde regel: bescherm de bron, bepaal wat daadwerkelijk binnen de scope valt, verifieer de bestemming en bewaar de oude kopie totdat normaal gebruik is bewezen.

Verplaats Zigbee- en Z-Wave-netwerken als afzonderlijke migratiestap

Als dezelfde USB-radio naar de nieuwe host verhuist, sluit je deze opnieuw aan en controleer je het apparaatspad. Als de nieuwe server een andere ingebouwde of vervangende radio gebruikt, migreer je het radionetwerk in plaats van ervan uit te gaan dat alleen de Home Assistant-back-up de identiteit van de coördinator wijzigt.

ZHA maakt automatisch netwerkback-ups en ondersteunt het migreren van een Zigbee-netwerk naar een andere ondersteunde coördinator zonder het volledige mesh-netwerk opnieuw te koppelen. Tijdens het migratieproces kan indien nodig ook de IEEE-identiteit van de radio worden overgezet.

Z-Wave heeft een afzonderlijke controllerstatus. Een recente discussie over de migratie van Z-Wave JS UI bevestigt dat de servicestore en een NVM-back-up de belangrijkste herstelmiddelen zijn bij het verplaatsen van de Z-Wave-service naar nieuwe hardware. Behandel beide radionetwerken als bedrijfsmiddelen met hun eigen herstelprocedures.

-15% OFF
Single board computer zimaboard2

Herstel eerst en verbind daarna externe opslag en netwerkservices opnieuw

Start de doelinstantie van Home Assistant op vanuit de back-up voordat je de router, DNS, NAS-machtigingen of meerdere serviceadressen tegelijk wijzigt. Een migratie is eenvoudiger te diagnosticeren wanneer de nieuwe host slechts op één belangrijke variabele tegelijk van de oude host verschilt.

Als de oude installatie netwerkopslag gebruikte, verbind je deze na het herstel opnieuw en controleer je de verwachte sharenamen en inloggegevens. Als er een externe database of MQTT-broker werd gebruikt, test je vanaf de nieuwe host de DNS- en TCP-connectiviteit voordat je de Home Assistant-configuratie wijzigt die al correct werkte.

De applicatiestatus kan worden verplaatst, maar hostspecifieke afhankelijkheden moeten nog steeds correct opnieuw worden aangemaakt. Houd het migratieoverzicht gericht op zaken die een Home Assistant-back-up niet fysiek kan verplaatsen: radio's, hostnetwerken, externe opslag, databaseservices, broker-eindpunten en implementatie-instellingen die door de oude server werden beheerd.

Voer een acceptatietest uit voordat je de oude server buiten gebruik stelt

  • Controleer of de verwachte gebruikers, dashboards, integraties, helpers, automatiseringen en ruimtes aanwezig zijn.
  • Activeer één belangrijke lokale automatisering en controleer of het fysieke apparaat feedback geeft.
  • Controleer of Zigbee-, Z-Wave-, Bluetooth- en andere radiodevices beschikbaar zijn.
  • Controleer of de geschiedenis en statistieken van Recorder normaal worden opgeslagen.
  • Test één pad naar netwerkopslag en één externe afhankelijkheid, zoals MQTT, indien gebruikt.
  • Test lokale en externe toegang afzonderlijk.
  • Herstart de nieuwe Home Assistant-host één keer en herhaal de kritieke test voor lokale bediening.

Pas wanneer deze test na de tweede start is geslaagd, kun je overwegen de oude server te wissen of opnieuw te gebruiken. Houd tot die tijd de broninstallatie uitgeschakeld, losgekoppeld van conflicterende radio's of IP-adressen en beschikbaar als referentie voor terugrollen.

Ondersteuning & Tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.