Backup Home Assistant: automatyczne kopie i odzyskiwanie systemu po awarii

Awaria karty SD, SSD albo całego urządzenia może zdarzyć się bez ostrzeżenia. Dobrze przygotowany backup pozwala wrócić do automatyzacji, integracji i dashboardów bez budowania systemu od początku.

Sama obecność pliku backupu nie wystarcza. Kopia powinna powstawać automatycznie, znajdować się także poza urządzeniem Home Assistant, mieć zachowane starsze wersje i klucz potrzebny do jej odszyfrowania.

Najważniejsza zasada: awaria jednego urządzenia nie może usunąć jednocześnie systemu i wszystkich jego kopii.

1. Włącz automatyczny backup i wybierz regularny harmonogram.
2. Zapisuj kopię przynajmniej w jednej lokalizacji poza urządzeniem Home Assistant.
3. Przechowuj kilka ostatnich wersji, a nie tylko najnowszy plik.
4. Zapisz emergency kit z kluczem szyfrowania poza Home Assistant.
5. Okresowo sprawdzaj dostępność kopii i przećwicz odtwarzanie w bezpiecznym środowisku.

To praktyczne zastosowanie zasady 3-2-1: kilka kopii danych, na więcej niż jednym nośniku i co najmniej jedna kopia poza głównym urządzeniem.

Pełny backup obejmuje katalogi config, share, ssl i media oraz ręcznie zainstalowane lub utworzone aplikacje. Oznacza to między innymi konfigurację, automatyzacje, dashboardy, dane integracji i bazę danych znajdującą się w katalogu konfiguracji.

Backup częściowy pozwala wybrać tylko potrzebne katalogi i aplikacje. Jest przydatny przy cofnięciu jednej części systemu, ale nie zastępuje pełnej kopii przeznaczonej do odzyskania całej instalacji.

Domyślnie lokalne archiwa .tar trafiają do katalogu /backup. Taki plik nadal znajduje się na tym samym urządzeniu, dlatego sam nie chroni przed uszkodzeniem jego nośnika.

1. Otwórz Ustawienia → System → Kopie zapasowe.
2. Wybierz konfigurację automatycznych kopii i pobierz emergency kit.
3. Ustaw harmonogram. Oficjalna dokumentacja zaleca kopię codzienną, ale częstotliwość dopasuj do liczby zmian w systemie.
4. Włącz backup przed aktualizacją, jeśli chcesz, aby był domyślnie proponowany przy aktualizacjach.
5. Ustal liczbę zachowywanych kopii. Starsze pliki będą automatycznie usuwane.
6. Wybierz dane oraz lokalizacje docelowe.

Duża baza Recorder, multimedia i folder share mogą znacznie wydłużyć tworzenie oraz odtwarzanie kopii. Przed migracją warto sprawdzić zajęte miejsce w informacjach systemowych i nie przechowywać niepotrzebnych danych.

Najprostsze minimum to pobieranie kopii na komputer lub zapis na innym urządzeniu w sieci. Home Assistant obsługuje również lokalizacje udostępniane przez integracje, między innymi Google Drive, Microsoft OneDrive i Synology DSM, a w Home Assistant OS można skonfigurować sieciową pamięć masową przeznaczoną na backupy.

Subskrybenci Home Assistant Cloud mogą przechowywać w chmurze ostatni backup o rozmiarze do 5 GB. Ta kopia jest zawsze szyfrowana. Ponieważ chmura zachowuje jeden ostatni plik, warto równolegle utrzymywać historię kopii w drugiej lokalizacji.

Dobra praktyka: używaj co najmniej dwóch miejsc, na przykład lokalnej historii na NAS oraz jednej kopii poza domem. Dostępność konkretnych lokalizacji zależy od zainstalowanych integracji i rodzaju instalacji.

Home Assistant używa klucza szyfrowania do ochrony backupów. Kopie w Home Assistant Cloud są zawsze szyfrowane, a dla pozostałych lokalizacji szyfrowanie można ustawić osobno. Od wersji 2026.4 nowe zaszyfrowane backupy używają zmodernizowanego formatu SecureTar v3; wcześniejsze kopie pozostają obsługiwane.

Emergency kit zawiera klucz i informacje potrzebne podczas odzyskiwania. Zapisz go poza Home Assistant, najlepiej w bezpiecznym menedżerze haseł oraz w dodatkowej chronionej kopii offline.

Utrata klucza może uniemożliwić odtworzenie zaszyfrowanego backupu. Jeżeli zmienisz klucz, zachowaj także poprzedni, ponieważ nowy klucz nie odszyfruje starszych kopii. Dopóki działający Home Assistant ma właściwy klucz, można go ponownie pobrać z ustawień backupu.

Nie ma jednej właściwej liczby dla każdego systemu. Rozsądny punkt wyjścia to kilka ostatnich kopii codziennych, dodatkowa kopia sprzed większej aktualizacji oraz co najmniej jedna nowsza kopia poza urządzeniem.

Nie polegaj wyłącznie na najnowszym backupie. Błąd konfiguracji albo uszkodzone dane mogą zostać zapisane również w nim, a problem może ujawnić się dopiero po kilku dniach. Retencja powinna zapewniać możliwość cofnięcia się do stanu sprzed problemu i mieścić się w dostępnej przestrzeni.

Regularnie kontroluj, czy zadania backupu kończą się powodzeniem, kopie są widoczne w wybranych lokalizacjach, można je pobrać, a emergency kit jest dostępny. Sam komunikat o utworzeniu pliku nie sprawdza całej procedury odzyskiwania.

Pełny test najlepiej wykonać na zapasowym urządzeniu lub w odizolowanym środowisku. Nie uruchamiaj jednocześnie dwóch identycznie odtworzonych instancji w tej samej sieci i nie podłączaj od razu koordynatorów radiowych. Mogłoby to spowodować konflikty, podwójne automatyzacje lub nieplanowane sterowanie urządzeniami.

Zapisz krótką instrukcję awaryjną: lokalizację kopii, miejsce przechowania klucza, sposób instalacji Home Assistant i listę urządzeń USB, które trzeba przełożyć. Test warto powtórzyć po dużej zmianie sprzętu lub sposobu przechowywania backupów.

1. Wymień uszkodzoną kartę SD lub SSD albo przygotuj urządzenie docelowe.
2. Zainstaluj świeży Home Assistant odpowiedni dla nowego sprzętu i uruchom ekran powitalny.
3. Wybierz przesłanie lokalnego backupu albo zaloguj się do Home Assistant Cloud, jeśli kopia była tam zapisana.
4. Zaznacz elementy do przywrócenia. Przy pełnej migracji wybierz całą konfigurację.
5. Wprowadź klucz szyfrowania z emergency kit i rozpocznij odtwarzanie.
6. Poczekaj cierpliwie. Większa instalacja może odtwarzać się około 45 minut, a chwilowy brak strony jest normalny. Nie odświeżaj ekranu podczas procesu.
7. Zaloguj się danymi używanymi w chwili utworzenia backupu.

Backup można odtworzyć na innym typie urządzenia, na przykład przenieść system z Raspberry Pi na mini PC. Urządzenie docelowe musi mieć wystarczająco dużo wolnego miejsca. Podłącz używane kontrolery USB, a przy zmianie radia Zigbee wykonaj właściwą migrację sieci Zigbee.

• Sprawdź integracje, urządzenia oraz encje niedostępne.
• Przetestuj najważniejsze automatyzacje, sceny i powiadomienia.
• Otwórz dashboardy i sprawdź historię oraz bazę danych.
• Zweryfikuj Zigbee, Z-Wave i inne kontrolery radiowe.
• Sprawdź aplikacje, dodatki i zewnętrzne usługi.
• Potwierdź certyfikaty, zdalny dostęp i aplikację mobilną.
• Podłącz ponownie pamięć sieciową, jeśli wymaga tego migracja.
• Przejrzyj logi i naprawy, a następnie wykonaj nowy backup sprawnego systemu.

Urządzenia bateryjne mogą przez pewien czas być niedostępne i pojawić się dopiero po wybudzeniu. Jeżeli wcześniej używałeś HTTPS bezpośrednio w integracji http, po odtworzeniu otwórz panel przez adres zaczynający się od https://.

• Wszystkie backupy znajdują się na tej samej karcie lub dysku co Home Assistant.
• Emergency kit jest zapisany wyłącznie wewnątrz systemu, który ma ratować.
• Zachowywana jest tylko jedna, najnowsza kopia.
• Nikt nie sprawdza nieudanych zadań ani wolnego miejsca.
• Backup powstaje dopiero przed ryzykowną zmianą, zamiast regularnie.
• Przywracanie jest uruchamiane na działającym systemie bez oceny, które dane zostaną nadpisane.
• Po migracji nie sprawdza się radia Zigbee, dostępu zdalnego i automatyzacji.

Jeżeli system przestał się uruchamiać, padł dysk lub karta SD, chcesz przenieść Home Assistant na nowy sprzęt albo nie masz pewności, czy Twoje kopie zapasowe są poprawnie skonfigurowane, mogę przeanalizować sytuację i pomóc bezpiecznie odtworzyć system.

Poradnik zweryfikowano 17 sierpnia 2026 r. na podstawie aktualnych oficjalnych materiałów Home Assistant:

• Tworzenie, przechowywanie i przywracanie backupów,
• Integracja Backup i automatyczne kopie,
• Emergency kit i klucz szyfrowania,
• Integracje udostępniające lokalizacje backupu,
• Modernizacja szyfrowania backupów w 2026 r..

Interfejs i dostępne lokalizacje mogą zmieniać się wraz z aktualizacjami. Przed odtwarzaniem sprawdź dokumentację odpowiadającą używanej wersji Home Assistant.