Kopia Home Assistant, którą da się odtworzyć

Plik backupu leży na tym samym dysku co Home Assistant. Panel pokazuje, że zadanie zakończyło się poprawnie. Potem dysk przestaje działać i razem z systemem znika jedyny egzemplarz kopii.

Przygotowanie do odzyskania obejmuje więcej niż utworzenie archiwum: znany zakres kopii, plik poza uszkadzającym się serwerem, właściwy klucz szyfrowania i sprawdzoną procedurę odtworzenia. Każdy z tych elementów odpowiada na inny problem.

Zacznij od informacji, jak zainstalowano Twój Home Assistant. Kopia Home Assistant OS i kopia instancji uruchomionej w kontenerze nie obejmują automatycznie identycznego otoczenia.[1]

Najpierw ustal, co rzeczywiście znajduje się w kopii

W Home Assistant OS podczas tworzenia kopii wybierasz jej zakres. Dokumentacja rozróżnia ustawienia Home Assistant, historię, wybrane foldery i aplikacje. Sam fakt utworzenia backupu nie potwierdza, że uwzględniono wszystkie składniki potrzebne do odbudowy Twojego systemu.[1]

W instalacji Home Assistant Container kopia dotyczy ustawień Home Assistant oraz opcjonalnie historii. Nie jest kopią całego hosta, konfiguracji wszystkich kontenerów i dowolnych zewnętrznych usług.[1]

Rozpisz zależności:

Dokumentacja wskazuje wprost, że baza historii działająca na innym systemie nie wchodzi automatycznie do backupu Home Assistant. Jeżeli baza działa jako aplikacja w Home Assistant OS, jej dane mogą być uwzględnione z tą aplikacją. Przy zewnętrznym serwerze bazy potrzebujesz osobnej procedury.[1]

Nie zakładaj też, że archiwum zawiera logi i wszystkie pliki tymczasowe. Niektóre dane są celowo pomijane. Zakres kopii sprawdzaj przed awarią, kiedy możesz jeszcze uzupełnić brakujące elementy.

Skonfiguruj harmonogram i obserwuj błędy

W aktualnej dokumentacji konfiguracja kopii znajduje się w Settings → System → Backups, czyli w ustawieniach systemu, w sekcji kopii zapasowych. Harmonogram automatyczny pozwala tworzyć kopie i usuwać starsze kopie automatyczne zgodnie z konfiguracją.[1]

Dobierz częstotliwość do tego, ile zmian jesteś gotów odtwarzać ręcznie. Dodatkową kopię wykonaj przed większą przebudową automatyzacji, migracją sprzętu albo inną zmianą, której cofnięcie może być trudne.

Po włączeniu harmonogramu sprawdź następne wykonanie. Ustal, czy plik powstał, czy zapisano wybrany zakres i czy trafił do wymaganej lokalizacji. Ostrzeżenie o błędzie części zadania nie powinno zniknąć pod ogólną informacją, że „backup jest”.

Przy problemach zacznij od dostępnego miejsca, uprawnień i osiągalności magazynu. Nie usuwaj ostatniej działającej kopii tylko po to, żeby uciszyć komunikat o braku miejsca. Najpierw zabezpiecz plik i ustal, co zajmuje przestrzeń.

Przenieś kopię poza serwer

Kopia na dysku Home Assistant pomaga przy niektórych błędach konfiguracji, ale pozostaje zależna od tego samego nośnika i hosta. Dodatkowy egzemplarz poza serwerem ogranicza ryzyko utraty obu naraz.

W zależności od instalacji możesz korzystać z obsługiwanej lokalizacji backupu, magazynu sieciowego lub pobrać plik i zapisać go na innym urządzeniu. Dostępność konkretnych lokalizacji oraz sposób konfiguracji sprawdź dla własnego typu instalacji.[1]

Magazyn NAS w tej samej szafce rozwiązuje inny problem niż kopia poza mieszkaniem. Zapisz, przed jaką awarią ma chronić każda lokalizacja. Ten prosty opis ułatwia zauważenie sytuacji, w której wszystkie egzemplarze zależą od jednego zasilacza, jednego konta albo jednego pomieszczenia.

Okresowo sprawdzaj, czy rzeczywiście potrafisz pobrać archiwum z wybranej lokalizacji. Ikona skonfigurowanej usługi nie potwierdza, że masz aktualny plik i dane pozwalające się do niego dostać po awarii.

Zachowaj emergency kit i odróżnij go od hasła logowania

Home Assistant domyślnie szyfruje kopie. Do odzyskania zaszyfrowanej kopii potrzebny jest właściwy klucz szyfrowania. Emergency kit, czyli zestaw awaryjny, zawiera ten klucz oraz informacje o instancji.[2]

Hasło użytkownika Home Assistant nie zastępuje klucza szyfrowania backupu. Zapisz zestaw awaryjny poza samym serwerem i sprawdź, czy odnajdziesz go bez dostępu do działającej instancji.

Jeśli zmieniasz klucz, zachowaj również poprzedni zestaw dla starszych kopii. Nowy klucz dotyczy kolejnych backupów i nie odszyfruje automatycznie archiwum utworzonego wcześniej innym kluczem.[2]

Dokumentacja ostrzega, że utraconego klucza zaszyfrowanej kopii nie odzyskasz przez pomoc Nabu Casa. Nie opieraj planu na założeniu, że ktoś później odblokuje archiwum za Ciebie.[2]

Archiwum i klucz przechowuj w kontrolowanych miejscach. Nie wklejaj ich do zgłoszenia na forum, publicznego dysku ani rozmowy z przypadkową osobą pomagającą przy konfiguracji.

Uważaj na odszyfrowanie podczas pobierania

Szyfrowanie w magazynie i postać pliku po pobraniu to dwa osobne zagadnienia. Dokumentacja Home Assistant opisuje pobieranie z panelu z odszyfrowaniem w trakcie transferu, tak aby dało się przeglądać dane archiwum. Dostępna jest również możliwość pobrania kopii zaszyfrowanej.[1]

Dlatego sprawdź opcję pobierania, zanim przeniesiesz plik na inny dysk lub do zewnętrznej usługi. Nie uznawaj każdego pobranego archiwum za zaszyfrowane tylko dlatego, że kopia przechowywana w usłudze była szyfrowana.

Odszyfrowany plik traktuj jak wrażliwy eksport konfiguracji domu. Może zawierać dane dostępowe i szczegóły instalacji. Na komputerze używanym do testu zadbaj o ograniczenie dostępu, a po zakończeniu usuń zbędne kopie robocze.

Nie utożsamiaj odzyskania Home Assistant z wymianą radia

ZHA wykonuje kopie sieci Zigbee i udostępnia procedurę migracji na obsługiwany adapter. Dokumentacja określa warunki takiej migracji oraz obsługiwane rodziny sprzętu.[3]

Nie traktuj jednak backupu Home Assistant jako obietnicy dowolnej wymiany koordynatora między wszystkimi integracjami i modelami. Najpierw ustal, czy używasz ZHA, czy Zigbee2MQTT, oraz jakie dane i procedura są potrzebne w Twoim wariancie.

Przygotuj model adaptera, wersję firmware i informację, gdzie zapisano konfigurację sieci. Samo skopiowanie pliku konfiguracyjnego nie jest uniwersalnym przepisem na migrację radia. Nie wgrywaj innego firmware do działającego koordynatora w ramach niezaplanowanej próby odzyskania.

Jeżeli obawiasz się problemu z łącznością, odróżnij go od utraty danych. Procedura diagnostyki Zigbee pomaga uniknąć odbudowy sieci, która nie była potrzebna.

Wykonaj próbę odtworzenia bez drugiego aktywnego domu

Odtworzenie backupu na obecnym systemie nadpisuje wybrane dane. Do nauki procedury użyj środowiska testowego, którego utrata nie zaszkodzi działającej instalacji.[1]

Przywrócona kopia zawiera również konfigurację integracji i automatyzacji. Nie uruchamiaj jej bez przygotowania w tej samej sieci, z dostępem do produkcyjnego brokera MQTT, urządzeń i usług chmurowych.

Bezpieczny plan próby redakcyjnej:

1. Przygotuj oddzielną instancję w odseparowanym środowisku testowym.
2. Zablokuj jej dostęp do produkcyjnych urządzeń, brokera i usług zewnętrznych, zanim uruchomisz odtworzony system.
3. Nie przekazuj jej adaptera USB używanego przez działający koordynator.
4. Odtwórz wybrany backup zgodnie z dokumentacją swojego typu instalacji i podaj właściwy klucz, jeśli jest wymagany.
5. Sprawdź konfigurację, automatyzacje, pulpity i wybrane dane, bez wykonywania poleceń na rzeczywistych urządzeniach.
6. Zapisz brakujące elementy i po teście wyłącz instancję testową.

W takiej próbie niedostępne integracje urządzeń są spodziewanym skutkiem izolacji. Test potwierdza możliwość odczytania i odtworzenia danych, a nie pełną komunikację z fizyczną instalacją. Rzeczywistą podmianę serwera i migrację adaptera zaplanuj jako osobne okno serwisowe.

Zostaw krótką instrukcję odzyskania

Zapisz miejsce przechowywania archiwum, sposób uzyskania właściwego klucza, typ instalacji i wynik ostatniej próby. Dodaj zależności pozostające poza backupem: host kontenerów, zewnętrzną bazę, sieć i adaptery.

Nie wpisuj sekretów do publicznej instrukcji. Zamiast tego wskaż uprawnionej osobie kontrolowany magazyn, w którym je odnajdzie. Plan powinien działać także wtedy, gdy serwer Home Assistant jest wyłączony.

Dla ciągłości działania przygotuj również test smart home bez internetu. Backup chroni możliwość odbudowy, a lokalna droga sterowania pomaga podczas innego rodzaju awarii.

Zacznij od pobrania jednej poprawnej kopii i właściwego zestawu awaryjnego. Następnie zaplanuj odseparowaną próbę odzyskania. Jeśli potrzebujesz pomocy w wyborze procedury, opisz na forum Domhub typ instalacji i usługi działające poza nią, bez załączania archiwum i kluczy.

Źródła i zakres

Dokumentację sprawdzono 4 listopada 2026 r. Dokładny zakres kopii, dostępne magazyny i ekran odtwarzania zależą od instalacji oraz wersji. Proponowana próba odseparowana jest procedurą organizacyjną, nie potwierdzeniem zgodności każdego adaptera lub systemu hosta.

• 1. Home Assistant: Backups. Zakres, lokalizacje, pobieranie i odtwarzanie kopii.
• 2. Home Assistant: Backup emergency kit. Klucz szyfrowania, zmiana klucza i konsekwencje jego utraty.
• 3. Home Assistant: ZHA, backups and migration. Kopie sieci i warunki migracji adaptera Zigbee.