Home Assistant po aktualizacji nie działa: jak to naprawić w 2026

Dlaczego Home Assistant przestał działać po aktualizacji?

Standardowy scenariusz. Włączasz system, a tu czarny ekran, błąd lub pętla restartów. Mało brakuje, żeby rzucić pilotem w ścianę. Spokojnie. Diabeł tkwi w szczegółach, a ja te szczegóły znam z autopsji.

Inny powód? Zmiany w bazie danych. Home Assistant używa SQLite. Duża aktualizacja może zmienić strukturę tabel. Jeśli migracja się nie uda, system staje. Brzmi poważnie. Często wystarczy ręczne uruchomienie naprawy bazy.

Z obserwacji dodatek HACS to największe źródło problemów. Sam go uwielbiam, ale po dużej aktualizacji lepiej go tymczasowo wyłączyć. Większość ludzi sądzi, że to wina głównego systemu. Cóż...

A co jeśli masz niestandardowe konfiguracje w configuration.yaml? Nowa składnia może je złamać. To zmienia wszystko. Trzeba czytać logi. I to dokładnie.

Nie zawsze. Czasem wystarczy restart. Ale jeśli problem wraca, to znak, że trzeba głębiej poszukać. I tu zaczyna się zabawa.

Krok 1: Sprawdź logi i typ błędu

Po aktualizacji Home Assistant nie reaguje? Zanim zaczniesz kombinować, zajrzyj do logów. To pierwsze miejsce, gdzie system sam powie Ci, co poszło nie tak. Brzmi prosto. I rzeczywiście takie jest.

Logi znajdziesz w interfejsie webowym pod Ustawienia > System > Logi. Gdyby interfejs nie działał, wejdź przez SSH albo konsolę. Wpisz docker logs homeassistant (jeśli używasz Dockera) lub journalctl -u home-assistant@homeassistant.

Patrz na trzy rzeczy:

• Czerwone wpisy z ERROR lub CRITICAL, to one wskazują konkretny problem.
• Brakujące integracje, po aktualizacji niektóre dodatki się wyłączają. Log pokaże coś w stylu "Platform not found".
• Błędy bazy danych, często winowajcą jest uszkodzona baza SQLite. W logu zobaczysz wtedy "Database corruption".

Nie każdy błąd to koniec świata. Często wystarczy zrestartować usługę albo odświeżyć konfigurację. Ale bez logów jesteś jak wędkarz na suchym stawie. Zero szans.

Krok 2: Przywróć kopię zapasową

Zanim cokolwiek klikniesz, wejdź w Ustawienia, potem System i Backup. Znajdziesz tam listę automatycznych kopii. Home Assistant domyślnie robi je co noc. Wybierz tę sprzed aktualizacji. Kliknij "Przywróć".

Moim zdaniem to najlepsza funkcja w całym systemie. Działa szybciej niż ponowna konfiguracja od zera. Nawet jeśli stracisz godzinę danych, odzyskasz działający dom. Mało brakuje, a wiele osób o tym zapomina.

Proces trwa zwykle 5-10 minut. System się zresetuje i wróci do stanu sprzed katastrofy. Diabeł tkwi w szczegółach. Upewnij się tylko, że backup jest kompletny. Sprawdź datę i rozmiar pliku. Backup wielkości 10 MB przy stu integracjach? Coś jest nie tak.

Nie działa przywracanie? Spróbuj ręcznie wgrać plik z karty SD lub dysku sieciowego. Czasem system gubi ścieżkę do lokalnego backupu. Trudno powiedzieć czemu. Ale działa.

Krok 3: Wykonaj czystą reinstalację bez utraty danych

Moim zdaniem to najskuteczniejsza metoda. Większość ludzi myśli, że reinstalacja to wyburzenie wszystkiego do zera. Cóż... prawda wygląda inaczej. Home Assistant przechowuje konfigurację w osobnych folderach. Możesz usunąć system, a dane zostawić. To zmienia wszystko. Oto co robisz. Zatrzymaj usługę Home Assistanta. Następnie znajdź katalog config na swojej maszynie. W systemach Raspberry Pi to zwykle `/home/homeassistant/.homeassistant`. Na serwerze z Dockerem ścieżka zależy od twojego mounta. Zapisz ten katalog w bezpiecznym miejscu. Kopię na zewnętrznym dysku albo w chmurze. Pracując nad projektem dla klienta z branży hotelarskiej, miałem sytuację, w której zrobiłem kopię zapasową wieczorem. Rano po aktualizacji system nie wstał. Kopia uratowała cały tydzień pracy nad automatyzacją recepcji. Potem odinstaluj Home Assistanta całkowicie. Zainstaluj go od nowa. Skopiuj stary katalog config do nowej instalacji. Uruchom system. Większość integracji i encji wróci do życia. Kilka dodatków może wymagać ponownego uwierzytelnienia, ale to detal. Diabeł tkwi w szczegółach. Upewnij się, że w katalogu config nie ma starych plików binarnych z poprzedniej wersji. Czasem zostają po nich artefakty. Lepiej zachować tylko pliki YAML i foldery z danymi. Mało brakuje, a można stracić wszystko przez jeden zbędny plik. Jeśli potrzebujesz szerszego kontekstu jak przygotować środowisko od zera, sprawdź główny artykuł na ten temat. Uwierz mi, czysta reinstalacja to jak reset twojego smartfona. Boli na chwilę, ale potem działa jak nowe.

Krok 4: Alternatywne metody odzyskiwania dostępu

Standardowe logowanie nie działa? Spokojnie. To nie koniec świata. Home Assistant ma kilka asów w rękawie na takie sytuacje. Z obserwacji najprościej działa dostęp przez konsolę.

A co jeśli nie masz dostępu do sprzętu? Spróbuj trybu awaryjnego. Przy starcie systemu naciśnij Shift. To ładuje tylko podstawowe komponenty. Bez dodatków i integracji. Brzmi prosto. W takim trybie możesz ręcznie poprawić plik configuration.yaml przez edytor plików.

Inna opcja to SSH. Jeśli wcześniej włączyłeś dodatek SSH, masz furtkę. Połącz się z terminalem. Wpisz ha core restart. Czasem to wystarcza. Gdyby i to zawiodło, sięgnij po kopię zapasową. Powinieneś mieć ją na pendrive lub w chmurze. Więcej o przygotowaniu systemu od zera znajdziesz w szerszym kontekście instalacji.

Ostatnia deska ratunku? Reset do ustawień fabrycznych. Nie lubię tego. To ostateczność. Ale czasem trzeba iść na całość. Pamiętaj o backupie. Inaczej stracisz wszystko. Nie warto ryzykować. Lepiej spędzić godzinę na odtwarzaniu niż cały dzień na konfiguracji od nowa.

Kiedy warto poczekać na nowszą wersję lub downgrade?

Zdarza się, że po aktualizacji Home Assistant działa gorzej. Wtedy myślisz o zmianach. Ale czasem lepiej nie działać pochopnie.

Downgrade ma sens tylko w konkretnych przypadkach:

• Gdy straciłeś dostęp do panelu administracyjnego
• Gdy przestały działać kluczowe automatyki (np. ogrzewanie)
• Gdy błąd jest udokumentowany na GitHubie i bez szybkiej poprawy

Ale uwaga. Cofanie wersji to nie jest czarna magia. Trzeba zrobić kopię zapasową. Bez tego ryzykujesz utratą konfiguracji. Moim zdaniem początkujący użytkownicy powinni uzbroić się w cierpliwość. Nowsza wersja często przynosi łatkę szybciej niż myślisz.

Jeśli dopiero zaczynasz przygodę z Home Assistant, sprawdź szerszy kontekst tego zagadnienia. Dowiesz się jak unikać problemów od samego startu.

I tu sedno. Downgrade to ostateczność. Nie awaryjne wyjście. Czasem lepiej poczekać. Brzmi prosto. W praktyce wielu o tym zapomina.