Home Assistant na PC, mini PC i laptopie – instalacja i konfiguracja od podstaw

Platforma x86-64 oznacza tutaj 64-bitowy komputer Intel lub AMD: komputer stacjonarny, mini PC, terminal albo odpowiedni laptop. Taki sprzęt ma sens, gdy chcesz przeznaczyć go tylko dla Home Assistanta albo świadomie uruchomić HAOS w maszynie wirtualnej.

Najważniejsza decyzja dotyczy sposobu instalacji: Home Assistant OS bezpośrednio na dysku, HAOS w maszynie wirtualnej albo Home Assistant Container w Dockerze. Główna instrukcja opisuje Home Assistant OS Generic x86-64 na osobnym komputerze.

• komputer Intel lub AMD obsługujący architekturę x86-64 i rozruch UEFI,
• sprawny dysk SATA, SSD, M.2 albo eMMC przeznaczony dla Home Assistanta,
• pendrive co najmniej 8 GB na Live Ubuntu,
• Ethernet oraz internet potrzebny podczas pierwszego uruchomienia,
• drugi komputer do przygotowania pendrive’a i późniejszej obsługi przez przeglądarkę,
• kopia wszystkich danych z komputera docelowego.

Sprawdź sprzęt przed instalacją: stan dysku, chłodzenie, działanie Ethernetu i możliwość automatycznego uruchomienia po powrocie zasilania. Potrzebne zasoby zależą od liczby integracji, historii, aplikacji i planowanego obciążenia.

Home Assistant OS i Home Assistant Container są obecnie dwoma wspieranymi typami instalacji. Dawne metody Home Assistant Core w środowisku Python oraz Home Assistant Supervised zostały wycofane ze wsparcia od wydania 2025.12 i nie są dobrym wyborem do nowej instalacji.

Ostrzeżenie: zapis Home Assistant OS nadpisze wybrany dysk. Znajdujący się na nim Windows, Linux, partycje odzyskiwania i pliki zostaną usunięte. Odłącz inne dyski, jeśli możesz, wykonaj kopię danych i przed rozpoczęciem zapisu sprawdź model oraz pojemność urządzenia. Tej instalacji nie wykonuj na dysku, z którego chcesz nadal uruchamiać dotychczasowy system.

1. Uruchom komputer i wejdź do ustawień firmware klawiszem F2, Del, F1, F10 lub klawiszem wskazanym przez producenta.
2. Ustaw tryb rozruchu UEFI. Nie wybieraj Legacy BIOS ani CSM.
3. Wyłącz Secure Boot.
4. Ustaw możliwość rozruchu z USB. Jeśli dostępna jest opcja przywrócenia zasilania, rozważ Power on after AC loss.
5. Zapisz zmiany. Menu różni się między producentami, dlatego nazwy mogą być podobne, ale nie identyczne.

1. Pobierz aktualny obraz Ubuntu Desktop i utwórz bootowalny pendrive zgodnie z instrukcją Ubuntu.
2. Włóż pendrive do komputera docelowego i wybierz go z menu rozruchowego. Uruchom wpis oznaczony jako UEFI.
3. Na ekranie Ubuntu wybierz Try Ubuntu, nie wybieraj Install Ubuntu.
4. Po uruchomieniu środowiska live połącz komputer z internetem i otwórz oficjalną instrukcję Generic x86-64.

Ubuntu działa teraz z pendrive’a i służy wyłącznie do zapisania obrazu HAOS na wewnętrznym dysku.

1. Z oficjalnej strony Generic x86-64 pobierz aktualny obraz Generic x86-64. Nie utrwalaj numeru wersji z poradnika.
2. W Ubuntu otwórz aplikację Disks / Dyski.
3. Po lewej wybierz wewnętrzny dysk docelowy. Zweryfikuj jego model i pojemność. Nie wybieraj pendrive’a z Ubuntu ani dysku z ważnymi danymi.
4. Otwórz menu z trzema kropkami i wybierz Restore Disk Image… / Przywróć obraz dysku….
5. Wskaż pobrany obraz HAOS, rozpocznij przywracanie i jeszcze raz potwierdź właściwy dysk.
6. Poczekaj do zakończenia. Jeśli pojawi się błąd zajętego systemu plików, sprawdź, czy uruchomiłeś Try Ubuntu z USB. Aktywną partycję swap na dysku docelowym zatrzymaj w aplikacji Dyski.
7. Wyłącz komputer z menu Ubuntu. Po pełnym wyłączeniu wyjmij pendrive.

Ostatnia kontrola: kliknięcie „Restore” rozpoczyna nadpisywanie całego wybranego dysku.

Alternatywnie: zapis dysku na drugim komputerze

Jeżeli nośnik docelowy można wyjąć lub podłączyć przez odpowiedni adapter, oficjalna instrukcja dopuszcza zapis obrazu na drugim komputerze programem Balena Etcher. Pobierz i rozpakuj aktualny obraz, wybierz Flash from file, wskaż właściwy nośnik i rozpocznij zapis. Dla niewyjmowalnego dysku laptopa wybierz Live Ubuntu.

1. Podłącz Ethernet do routera lub switcha z dostępem do internetu.
2. Włącz komputer. Jeżeli nadal uruchamia się USB, usuń pendrive lub zmień kolejność rozruchu.
3. Na podłączonym monitorze powinien pojawić się ekran konsoli Home Assistant. Monitor i klawiatura nie będą później potrzebne do normalnej obsługi.
4. Na innym urządzeniu w tej samej sieci otwórz kolejno: http://homeassistant.local:8123, http://homeassistant:8123 albo http://ADRES_IP:8123.
5. Adres IP znajdziesz w liście klientów DHCP routera.

Pierwszy start wymaga internetu, ponieważ HAOS pobiera najnowszy Home Assistant Core. Przygotowanie może potrwać; nie wyłączaj urządzenia w trakcie.

1. Wybierz utworzenie nowego inteligentnego domu albo wgraj kopię zapasową poprzedniej instalacji.
2. Utwórz konto właściciela i ustaw silne, unikalne hasło.
3. Ustaw lokalizację domu, strefę czasową, jednostki i walutę.
4. Zdecyduj o udostępnianiu anonimowych danych, a następnie zakończ kreator.
5. Sprawdź wykryte urządzenia i przejdź do głównego dashboardu.

VM ma sens, gdy komputer ma równocześnie obsługiwać inne usługi albo gdy już zarządzasz VirtualBox, KVM/Proxmox lub VMware. Pobierz obraz przygotowany dla wybranego hypervisora: VDI, QCOW2 albo OVA.

• oficjalne minimum maszyny to 2 GB RAM i 2 vCPU; zasoby dobierz do obciążenia,
• włącz EFI/UEFI dla maszyny wirtualnej,
• użyj mostkowanej karty sieciowej, aby HA był widoczny w sieci lokalnej,
• ustaw automatyczny start VM po uruchomieniu hosta,
• dla koordynatora Zigbee lub Z-Wave skonfiguruj stały USB passthrough i unikaj zmieniających się identyfikatorów portów.

USB Zigbee i Z-Wave może działać w VM, ale radio musi być przekazane wyłącznie do tej maszyny. Po restarcie hosta sprawdź, czy nadal zostało poprawnie dołączone.

Container jest wspieraną metodą dla osób, które chcą utrzymywać własny Linux i Docker Engine. Nie oferuje Supervisora ani aplikacji HAOS. Broker MQTT, Zigbee2MQTT, Z-Wave JS i inne usługi uruchamia się oraz aktualizuje jako oddzielne kontenery.

Oficjalna dokumentacja wymaga obecnie Docker Engine 23.0.0 lub nowszego i zaznacza, że Docker Desktop nie jest odpowiednim środowiskiem. Konfigurację trzeba trwale zamontować w /config, ustawić strefę czasową i sposób dostępu do potrzebnych urządzeń.

Nie wybieraj Containera tylko dlatego, że znasz słowo Docker. To dobry wariant, jeśli potrafisz samodzielnie utrzymywać system hosta, sieć kontenerów, aktualizacje, kopie i urządzenia USB.

1. Na starym urządzeniu przejdź do Ustawienia → System → Kopie zapasowe i utwórz aktualną pełną kopię.
2. Pobierz plik kopii na inny komputer lub zapisz go w skonfigurowanej lokalizacji zewnętrznej. Kopia pozostawiona wyłącznie na starym urządzeniu nie wystarczy w razie awarii nośnika.
3. Pobierz backup emergency kit i zachowaj klucz szyfrowania. Jest potrzebny do odszyfrowania aktualnych kopii.
4. Sprawdź zajęte miejsce starej instalacji. Nowy nośnik musi mieć więcej wolnej przestrzeni niż zajmuje system źródłowy; rozmiar samego pliku kopii nie pokazuje całego zapotrzebowania.
5. Zainstaluj HAOS na nowym komputerze. Na ekranie powitalnym wybierz Upload backup, wskaż plik, wybierz elementy do odtworzenia i podaj klucz z emergency kit.
6. Nie odświeżaj strony podczas przywracania. Po zakończeniu zaloguj się danymi ze starego systemu.
7. Podłącz dotychczasowe koordynatory Zigbee/Z-Wave i inne urządzenia USB, a następnie sprawdź ścieżki sprzętowe, integracje, magazyny sieciowe oraz encje niedostępne.

Migracja z Raspberry Pi: kopię z Raspberry Pi można przywrócić na komputerze x86-64 podczas onboardingu. Jeśli przechodzisz równocześnie na inne radio Zigbee, wykonaj osobną migrację radia zgodnie z dokumentacją używanej integracji.

Te zasady dotyczą koordynatorów Zigbee/Z-Wave oraz adapterów Bluetooth USB. Wbudowany Bluetooth zależy od zgodności sprzętu i wybranej metody instalacji; nie zakładaj jego działania bez sprawdzenia.

1. Aktualizacje: sprawdź aktualizacje HAOS, Core, Supervisora i aplikacji.
2. Kopie zapasowe: w Ustawienia → System → Kopie zapasowe ustaw harmonogram, pobierz emergency kit i przechowuj co najmniej jedną kopię poza serwerem.
3. Stały adres: utwórz rezerwację DHCP w routerze.
4. Zasilanie: ustaw automatyczne uruchamianie po zaniku prądu i rozważ UPS.
5. Laptop: sprawdź w praktyce zachowanie po zamknięciu pokrywy oraz po powrocie zasilania. Nie dopuść do uśpienia serwera.
6. Dostęp zdalny: nie wystawiaj zwykłego portu 8123 bezpośrednio do internetu. Użyj Home Assistant Cloud albo poprawnie skonfigurowanego VPN.

Jeżeli komputer nie uruchamia HAOS, sieć nie działa, przywracanie kopii się nie udało albo cała procedura jest zbyt skomplikowana, nie musisz analizować wszystkiego samodzielnie. Mogę sprawdzić problem i pomóc przy instalacji, migracji z Raspberry Pi lub innego urządzenia, konfiguracji sieci i dalszej diagnostyce. Najpierw ocenię, czy pomoc zdalna ma w danym przypadku sens.

Poradnik sprawdzono 12 sierpnia 2026 r. na podstawie aktualnych oficjalnych materiałów:

• Home Assistant: Installation,
• Generic x86-64,
• instalacja w maszynie wirtualnej,
• Home Assistant Container na Linuxie,
• onboarding i kopie zapasowe,
• oficjalny komunikat o Core i Supervised,
• oficjalna instrukcja Raspberry Pi, dla porównania zakresu.