Home Assistant na Proxmox VM: instalacja i USB Zigbee passthrough

Dlaczego Home Assistant na Proxmox VM to dobry wybór w 2026 roku

Postawić Home Assistant na gołym sprzęcie, czy w maszynie wirtualnej na Proxmox? To pytanie wraca jak bumerang na każdym forum o automatyce. Przez długi czas popularna była prosta odpowiedź: tylko dedykowany mini PC, bo inaczej będziesz walczył z USB i siecią. W 2026 roku ten argument się rozmywa.

Proxmox to hiperwizor typu 1 oparty na Debianie, z natywnym wsparciem LXC i KVM. Home Assistant możesz tam uruchomić jako maszynę wirtualną z obrazem HAOS, obok kilku kontenerów na inne usługi. Jeden komputer, wiele systemów, wspólne kopie zapasowe. Brzmi wygodnie, prawda?

Największa zaleta jest banalnie prosta. Snapshot przed każdą aktualizacją zajmuje sekundy. Coś się wysypie po update? Przywracasz stan sprzed zmiany i wracasz do życia. Na instalacji bare metal taka operacja to zwykle godziny zabawy z backupem.

• Izolacja usług: Home Assistant, AdGuard, Node-RED i serwer plików działają niezależnie, awaria jednego nie kładzie reszty.
• Kopie i snapshoty: pełny rollback systemu bez reinstalacji i odtwarzania konfiguracji z plików.
• Elastyczne zasoby: dodasz RAM albo rdzenie do VM jednym kliknięciem, bez wymiany sprzętu.
• Jeden sprzęt do wszystkiego: mniej kabli, mniej poboru prądu, jedna szafka zamiast trzech pudełek.
• Migracja: przeniesienie VM na inny host Proxmox to kwestia kilku minut, nie weekendu.

Moim zdaniem instalacja HAOS jako VM na Proxmox działa lepiej niż kontener LXC z Home Assistant Container, ponieważ oficjalny obraz VM dostaje pełne wsparcie dodatków, Supervisor i aktualizacji z panelu. Kontener jest lżejszy i szybszy w starcie, tylko że wtedy tracisz sklep z dodatkami i część integracji wymaga ręcznej konfiguracji. Wybór zależy od tego, ile chcesz dłubać przy systemie.

Typowy przykład: masz jeden mini PC pod biurkiem, a na nim Home Assistant, Pi-hole i serwer multimediów. Gdy aktualizacja HA coś zepsuje, wracasz snapshotem do poprzedniej wersji, a pozostałe usługi nawet nie drgną. Bez owijania w bawełnę: to wygoda, której bare metal nie da.

Jest tylko jedno "ale". Cała ta układanka stoi na USB passthrough. Bez dobrze skonfigurowanego przekazania klucza Zigbee do VM twój koordynator po prostu nie zostanie wykryty. I tu zaczyna się właściwa robota.

Przygotowanie Proxmox VE i utworzenie maszyny wirtualnej dla Home Assistant OS

Zakładam, że masz już zainstalowany Proxmox VE w wersji 8.x. Jeśli nie, zatrzymaj się tutaj i najpierw postaw hypervisor, bo bez tego dalsze kroki nie mają sensu. Sam proces tworzenia VM dla Home Assistant OS jest prosty, ale diabeł tkwi w szczegółach, zwłaszcza gdy później dochodzi passthrough USB.

Zanim klikniesz cokolwiek, przygotuj trzy rzeczy: obraz haos_ova-XX.X.qcow2 ze strony Home Assistant, wolny storage na dyski VM oraz nazwę bridge'a sieciowego (domyślnie vmbr0). Bez tego utkniesz w połowie kreatora.

1. Wgraj obraz HAOS na Proxmox: local → ISO Images → Upload, albo wrzuć plik po SSH do /var/lib/vz/template/iso/.
2. Utwórz VM przez Create VM: nazwa dowolna, ID zostaw domyślne, zaznacz Start at boot jeśli chcesz, żeby HA wstawał po restarcie hosta.
3. W zakładce OS wybierz Do not use any media, a typ gościa ustaw na Other (Linux 6.x bywa kapryśny przy HAOS).
4. Dyski: Bus/Device ustaw na VirtIO Block lub SCSI, rozmiar 32 GB w zupełności wystarczy, a nawet 16 GB da radę przy skromnej bazie.
5. CPU: 2 rdzenie (typ host), RAM: minimum 2 GB, komfortowo 4 GB. Więcej nie zaszkodzi, ale HAOS nie pożera zasobów.
6. Sieć: bridge vmbr0, model VirtIO (paravirtualized). To ważne, bo emulowana karta sieciowa potrafi zamulić komunikację z Zigbee.

Po utworzeniu VM nie odpalaj jej jeszcze. Najpierw zaimportuj obraz HAOS do dysku:

qm importdisk 100 /var/lib/vz/template/iso/haos_ova-XX.X.qcow2 local-lvm

Numer 100 to ID twojej VM, a local-lvm to nazwa storage. Po imporcie wejdź w Hardware, znajdź nieużywany dysk i podepnij go jako sata0 lub scsi0. Ustaw go jako pierwszy w kolejności bootowania w Options → Boot Order.

Moim zdaniem dla HAOS lepszy jest dysk na SCSI z kontrolerem VirtIO SCSI single niż domyślne IDE, ponieważ daje zauważalnie lepszą wydajność I/O przy bazie recorder i nie obciąża CPU tak jak emulacja IDE. Różnica bywa odczuwalna, gdy logi i historia rosną.

Odpal VM. Powinieneś zobaczyć konsolę HAOS z informacją o adresie IP. Wejdź na homeassistant.local:8123 albo pod ten IP. Pierwsza konfiguracja zajmie kilka minut.

Dopiero teraz, gdy system wstaje, warto wrócić do hosta i zająć się passthrough USB. Bez działającej VM nie ma sensu mapować urządzeń, bo nie sprawdzisz, czy trafiły tam, gdzie trzeba. A co jeśli VM nie startuje? Sprawdź boot order. Często to jedyny problem.

Instalacja Home Assistant OS na VM krok po kroku

Zakładam, że Proxmox masz już zainstalowany i dostęp do panelu przez przeglądarkę działa. Sam proces sprowadza się do pobrania obrazu, utworzenia VM i jednej poprawki w konfiguracji. Brzmi prosto.

Najpierw ściągnij plik haos_ova-x.x.qcow2.xz ze strony Home Assistant i rozpakuj go na hoście. Potem w Proxmoxie tworzysz nową maszynę wirtualną typu Linux, bez systemu instalacyjnego, bo obraz jest gotowy do uruchomienia. Pamiętaj o dwóch rzeczach: maszyna musi startować w trybie UEFI, a nie BIOS, i warto od razu ustawić typ procesora na host.

Skoro masz gotową VM, kolejność wygląda tak:

1. Utwórz maszynę wirtualną i wskaż dysk z rozpakowanym obrazem Home Assistant OS.
2. Ustaw BIOS na OVMF (UEFI) i dodaj dysk EFI, inaczej system nie wstanie.
3. Przypisz co najmniej 2 rdzenie i 2 GB RAM, więcej jeśli planujesz dodatek Zigbee2MQTT.
4. Uruchom VM i poczekaj, aż w konsoli pojawi się adres IP oraz zachęta do wejścia na port 8123.

I tu zaczyna się problem. Świeżo postawiona VM bez internetu przez DNS potrafi się zatrzymać na etapie pobierania dodatków. Sprawdź, czy w ustawieniach sieci VM jest mostek do twojej karty, a nie tryb NAT, bo ten drugi utrudnia późniejsze wykrywanie urządzeń w sieci.

Moim zdaniem instalacja HAOS na Proxmox działa lepiej niż obraz na Raspberry Pi, ponieważ masz snapshoty przed każdą aktualizacją i nie ryzykujesz utraty całej konfiguracji po nieudanym upgrade. Karta SD w malince pada częściej, niż chciałoby się przyznać.

Pierwszy start trwa kilka minut. Gdy interfejs się wczyta, przejdź przez kreatora i wróć do ustawień VM, bo czeka cię jeszcze przekazanie portu USB do Zigbee. O tym w kolejnej sekcji.

Konfiguracja USB passthrough dla koordynatora Zigbee w Proxmox

Masz Home Assistant na maszynie wirtualnej. Zostaje najtrudniejszy krok: przekazanie fizycznego koordynatora Zigbee do VM. Bez tego cała instalacja jest bezużyteczna, bo Home Assistant nie zobaczy ani jednego czujnika. Diabeł tkwi w szczegółach, a Proxmox nie ułatwia sprawy, gdy w grę wchodzi USB.

Zanim cokolwiek skonfigurujesz, musisz ustalić identyfikator urządzenia. Podłącz koordynator (ConBee II, Sonoff ZBDongle-P, SLZB-06 w trybie USB) i w konsoli Proxmox wpisz lsusb. Szukaj linii z nazwą producenta. Zwróć uwagę na dwie liczby po słowie ID: pierwszą jest identyfikator dostawcy, drugą identyfikator produktu. Zapisz oba, bo przydadzą się przy edycji pliku konfiguracyjnego VM.

Typowy przykład: konfigurujesz VM o numerze 100, a Twój koordynator to Sonoff z identyfikatorem 10c4:ea60. W pliku /etc/pve/qemu-server/100.conf dopisujesz linię usb0: host=10c4:ea60. Restart VM i urządzenie pojawia się w systemie gościa. Brzmi prosto. Tylko że po restarcie Proxmoxa numeracja portów bywa inna, więc lepiej używać identyfikatora niż numeru magistrali.

• Użyj identyfikatora dostawcy i produktu zamiast numeru portu, bo numeracja może się zmieniać po restarcie hosta.
• Sprawdź, czy koordynator nie jest już przechwycony przez hosta, na przykład przez moduł jądra obsługujący porty szeregowe.
• W Home Assistant podaj ścieżkę urządzenia z katalogu /dev/serial/by-id, a nie surowe /dev/ttyUSB0.
• Po każdej aktualizacji Proxmoxa zweryfikuj, czy przekazanie USB nadal działa, zanim uznasz temat za zamknięty.

Moim zdaniem przekazywanie całego kontrolera USB przez hostpci działa lepiej niż pojedyncze usb passthrough dla koordynatora Zigbee. Różnica jest prosta: przy hostpci VM dostaje cały kontroler wraz ze wszystkimi urządzeniami, więc urządzenie nie znika przy restarcie, a sterownik w systemie gościa widzi je stabilniej. Przy pojedynczym przekazaniu USB zdarza się, że po ponownym uruchomieniu Proxmoxa koordynator nie wraca do VM. Wadą hostpci jest to, że tracisz ten kontroler dla hosta, więc potrzebujesz wolnego portu na inne urządzenia.

A co jeśli masz tylko jeden kontroler USB i używasz go też do dysku zewnętrznego? Wtedy zostaje passthrough pojedynczego urządzenia. Działa, tylko wymaga dyscypliny przy każdej zmianie sprzętu.

Rozwiązywanie problemów z USB passthrough i stabilność pracy

Podłączenie koordynatora Zigbee przez USB passthrough do maszyny wirtualnej z Home Assistant brzmi prosto, dopóki nie przestanie działać. A że potrafi przestać, to pewne. Najczęstszy objaw? Po restarcie hosta Proxmox urządzenie znika z listy dostępnych portów i automatyzacje stają się bezużyteczne.

Problem prawie zawsze wynika z tego, że passthrough zrobiony po numerze portu (/dev/ttyUSB0) jest kruchy. Wystarczy, że system po reboocie nada inne numery, i już podmienia się kolejność urządzeń. Rozwiązanie jest jedno: pracować na identyfikatorze sprzętowym, nie na ścieżce.

• Ustal identyfikator urządzenia komendą ls -l /dev/serial/by-id/ i wpisz go do konfiguracji VM zamiast /dev/ttyUSB0.
• Sprawdź, czy host nie przełącza urządzenia w tryb oszczędzania energii, bo to powoduje losowe rozłączenia w nocy.
• Dodaj regułę udev, jeśli koordynator po restarcie dostaje inny numer za każdym razem.
• Zaktualizuj firmware koordynatora, bo część modeli ma znane problemy ze stabilnością na starszych wersjach.
• Ustaw VM jako start on boot, żeby kolejność uruchamiania była przewidywalna.

Typowy scenariusz: działa przez tydzień, potem nagle tracisz wszystkie urządzenia Zigbee. Zaglądasz do logów, widzisz masę błędów połączenia, a w Proxmox urządzenie jest, tylko pod inną nazwą. Brzmi znajomo? To klasyka.

Moim zdaniem lepiej od razu zainwestować w konfigurację opartą na by-id niż łatać problem doraźnie, ponieważ eliminuje to całą klasę błędów związanych z kolejnością urządzeń. Ta metoda jest odporna na restarty i zmiany w systemie, a numer portu nie.

Jeśli problemy wracają mimo poprawnej konfiguracji, warto sprawdzić kabel i zasilanie. Tanie przedłużacze USB potrafią siać zakłócenia, a koordynator bez odpowiedniego zasilania gubi pakiety. Czasem diabeł tkwi w szczegółach, których wcale nie podejrzewasz.

Najczęściej zadawane pytania (FAQ)

Czy Home Assistant na Proxmox VM to dobry wybór na start? Zależy, czego oczekujesz. Jeśli chcesz mieć pełną kontrolę nad systemem i nie boisz się kilku dodatkowych kroków konfiguracji, VM na Proxmox daje sporo możliwości. Jeśli szukasz rozwiązania "włącz i działa", lepszym wyborem bywa instalacja na dedykowanym sprzęcie, np. mini PC z Home Assistant OS. Różnice między tymi podejściami opisałem szerzej w artykule Home Assistant OS vs Supervised vs Container.

Poniżej zebrałem pytania, które pojawiają się najczęściej przy konfiguracji USB passthrough i adapterów Zigbee. Odpowiedzi opieram na dokumentacji Proxmox i Home Assistant oraz na tym, co sam testowałem więcej na ten temat znajdziesz w naszym przewodniku: "Home assistant os vs supervised vs container".

Szybkie zestawienie typowych problemów

Czy muszę używać Zigbee USB, czy wystarczy sieciowy gateway?

To zależy od skali. Przy kilku czujnikach gateway sieciowy bywa wygodniejszy, ale przy większej liczbie urządzeń lokalny koordynator USB daje większą kontrolę i mniejsze opóźnienia. Diabeł tkwi w szczegółach: niektóre gatewaye zamykają się na własny ekosystem, co utrudnia integrację z Home Assistant.

Czy passthrough USB spowalnia VM?

Nie zauważyłem, żeby sam passthrough miał istotny wpływ na wydajność. Wąskim gardłem bywa raczej jakość adaptera i zakłócenia w paśmie 2,4 GHz. A co jeśli masz kilka VM na jednym hoście? Wtedy warto pilnować przydziału zasobów.

Jak zaktualizować Home Assistant w VM?

Zależnie od metody instalacji. W wersji OS aktualizacja odbywa się z poziomu interfejsu. Przy instalacji kontenerowej musisz zadbać o to samodzielnie. Jeśli coś się zmieniło od publikacji, daj znać w komentarzu.