SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

Home Assistant op Proxmox: VM of LXC? Kies de HAOS-VM

Alleen Home Assistant OS in een VM geeft je apps zoals Tailscale. Zo installeer je HAOS 18.4 op Proxmox VE 9.2 met qm, UEFI zonder Secure Boot en je Zigbee-stick erbij.

Het korte antwoord: een VM met Home Assistant OS

Wil je Home Assistant op Proxmox draaien, kies dan een VM met Home Assistant OS (HAOS) en geen LXC-container. Alleen HAOS geeft je apps, zoals de Tailscale-app. Sinds Home Assistant 2026.2 heten add-ons apps. Over de Container-installatie zegt de installatiepagina van Home Assistant letterlijk: "This installation type does not have access to apps."

Deze handleiding gaat uit van een mini-pc met Proxmox VE 9.2. Je installeert HAOS 18.4. Dat is de x86-64-image die op 19 november 2026 op de installatiepagina van Home Assistant staat. Je bouwt de VM met de hand met qm, het commando van Proxmox voor VM's. Zo weet je van elke instelling waarom die er staat. Daarna lees je hoe je een Zigbee-stick doorgeeft, hoe back-ups werken en wat het community-script anders doet.

Waarom Home Assistant in een LXC een doodlopende weg is

Home Assistant ondersteunt nog twee installatiemethoden: Home Assistant OS en Home Assistant Container. Dat staat in de blogpost van 22 mei 2025. Daarin schafte het project de methoden Core en Supervised af. Die twee kregen nog ondersteuning tot en met release 2025.12. Daarna neemt het project voor die methoden geen issue reports meer aan.

Een LXC-handleiding die Core of Supervised installeert, volgt dus een methode die niet meer ondersteund wordt. Loop je daarmee vast, dan kun je het probleem niet meer bij Home Assistant melden. De installatiepagina's van Home Assistant noemen ook geen aparte LXC-methode.

Wat in een LXC wel kan, is de Container-methode: Home Assistant in Docker. Dan heb je ook de grens van Container. Er draait geen Supervisor, dus er is geen app-winkel en je kunt geen apps installeren. HAOS bevat juist wel Home Assistant Core plus de Supervisor, en de Supervisor beheert de apps.

HAOS is een compleet besturingssysteem met een eigen kernel. Een LXC-container deelt de kernel van de Proxmox-host, dus een besturingssysteem met een eigen kernel past daar niet in. Een VM geeft HAOS die eigen kernel wel. Het blog van Home Assistant raadt zelf aan om HAOS in een virtuele machine te draaien, "like with Proxmox". De algemene theorie over VM's en containers staat in het verschil tussen KVM, Xen en LXC. Deze pagina blijft bij Home Assistant.

Wat je nodig hebt voor de HAOS-VM

  • Een Proxmox VE 9.x-host. Controleer je versie met pveversion op de host.
  • Genoeg geheugen. De Linux/KVM-pagina van Home Assistant noemt als minimum 2 GB RAM en 2 vCPU's. Het virt-install-voorbeeld op dezelfde pagina gebruikt 4096 MB. Deze handleiding neemt dat voorbeeld over.
  • De naam van je opslag. pvesm status toont die. Op veel installaties heet de opslag voor VM-schijven local-lvm. Staat er bij jou een andere naam, vervang dan local-lvm in elk commando hieronder.
  • Een vrij VM-nummer. pvesh get /cluster/nextid geeft het eerstvolgende vrije nummer. De voorbeelden gebruiken 100.
  • De netwerkbrug van je host, meestal vmbr0. Daarmee krijgt de VM een eigen adres in je thuisnetwerk, naast je router en je andere apparaten.
pveversion
pvesm status
pvesh get /cluster/nextid

Stap 1: de officiële HAOS-image downloaden

Home Assistant levert voor KVM een kant-en-klare schijf in qcow2-formaat. Proxmox gebruikt KVM, dus dit is de juiste image. Download hem op de Proxmox-host en pak hem uit.

cd /root
wget https://github.com/home-assistant/operating-system/releases/download/18.4/haos_ova-18.4.qcow2.xz
xz -d haos_ova-18.4.qcow2.xz
qemu-img info haos_ova-18.4.qcow2

qemu-img info moet file format: qcow2 tonen, plus de virtuele grootte van de schijf. Geeft xz -d of qemu-img info een foutmelding, download het bestand dan opnieuw.

Op de releasepagina staat ook een versie 18.5. Volgens de release notes is dat een beveiligingsrelease die alleen voor de Raspberry Pi is bedoeld: "Raspberry Pi only". Voor een mini-pc is 18.4 dus de juiste image. Kijk wel op de installatiepagina van Home Assistant of er inmiddels een nieuwere versie voor KVM staat. Pas dan het versienummer in de commando's aan.

Stap 2: de VM aanmaken met UEFI zonder Secure Boot

Twee eisen van Home Assistant bepalen deze stap. De eerste: "Home Assistant requires UEFI to boot." De tweede staat in de KVM-stappen: kies een versie van OVMF (de UEFI-firmware voor VM's) zonder Secure Boot. Proxmox start een VM standaard met SeaBIOS, een klassieke BIOS. Daarom zet je --bios ovmf expliciet.

qm create 100 --name homeassistant --machine q35 --bios ovmf --ostype l26 --cores 2 --memory 4096
qm set 100 --scsihw virtio-scsi-pci --net0 virtio,bridge=vmbr0 --agent 1
qm set 100 --efidisk0 local-lvm:1,efitype=4m,pre-enrolled-keys=0
qm config 100

Dit doen de opties:

  • --bios ovmf start de VM met UEFI. Zonder deze optie start HAOS niet, want HAOS heeft UEFI nodig.
  • --efidisk0 maakt de kleine EFI-schijf waarin OVMF zijn instellingen bewaart. pre-enrolled-keys=0 is hier de belangrijke instelling. De Proxmox-documentatie zegt dat vooraf ingeschreven sleutels ook Secure Boot standaard aanzetten. Home Assistant vraagt juist om firmware zonder Secure Boot, dus je schrijft geen sleutels in.
  • --agent 1 zet het kanaal voor de QEMU guest agent aan. De KVM-stappen van Home Assistant voegen datzelfde kanaal toe: org.qemu.guest_agent.0.
  • --machine q35, --scsihw virtio-scsi-pci en --ostype l26 zijn keuzes voor een moderne Linux-VM. Home Assistant schrijft ze niet voor. De standaardwaarden van Proxmox zijn anders: lsi voor de SCSI-controller en other voor het type besturingssysteem.

qm config 100 moet nu onder meer bios: ovmf en een regel efidisk0: met efitype=4m en pre-enrolled-keys=0 tonen.

Stap 3: de schijf importeren en als opstartschijf instellen

qm disk import zet de image op je Proxmox-opslag. De schijf komt eerst binnen als ongebruikte schijf. Daarna koppel je hem zelf.

qm disk import 100 haos_ova-18.4.qcow2 local-lvm
qm config 100 | grep unused

De tweede regel toont iets als unused0: local-lvm:vm-100-disk-1. Neem precies die naam over in het volgende commando. Gok de naam niet, maar lees hem af.

qm set 100 --scsi0 local-lvm:vm-100-disk-1,discard=on,ssd=1
qm set 100 --boot order=scsi0 --onboot 1

--boot order=scsi0 laat de firmware van deze schijf starten. --onboot 1 start de VM automatisch als de Proxmox-host opstart. De standaardwaarde is 0. Dan start Home Assistant na een stroomstoring niet vanzelf weer op.

Wil je meer ruimte dan de image meebrengt, vergroot de schijf dan nu:

qm disk resize 100 scsi0 64G

Een waarde zonder plusteken is de nieuwe totale grootte. Met +16G tel je er 16 GB bij op. Kleiner maken kan niet. Controleer na de eerste start in Home Assistant of de extra ruimte zichtbaar is.

Stap 4: starten en de eerste keer inloggen

qm start 100
qm status 100
qm guest cmd 100 ping

qm status moet status: running tonen. qm guest cmd 100 ping controleert of de guest agent in HAOS antwoordt. Antwoordt de agent, dan krijg je geen foutmelding. Direct na de start kan de agent nog niet antwoorden, want HAOS start dan nog op. Probeer het na een paar minuten opnieuw.

Open daarna http://homeassistant.local/ in je browser. Werkt dat niet, probeer dan http://homeassistant.local:8123/. Bij de eerste start downloadt HAOS de nieuwste versie van Home Assistant. Volgens de documentatie kan dat 20 minuten of langer duren. Heb je al een back-up van een oude installatie, kies dan op het welkomstscherm de optie onder Or restore.

Waarom start de HAOS-VM niet?

Controleer bij een mislukte start eerst deze punten. qm config 100 toont de instellingen die je nodig hebt.

  • De VM gebruikt SeaBIOS. Staat er geen regel bios: ovmf in de configuratie, dan start de VM met BIOS. HAOS heeft UEFI nodig, dus het systeem start niet. Zet het goed met qm set 100 --bios ovmf en controleer of er een efidisk0 is.
  • Secure Boot staat aan. Heb je de EFI-schijf gemaakt met pre-enrolled-keys=1, of in de webinterface gekozen voor vooraf ingeschreven sleutels, dan staat Secure Boot standaard aan. Volgens de Proxmox-documentatie kun je Secure Boot uitzetten in het OVMF-menu in de VM. Open daarvoor de console van de VM in de Proxmox-webinterface.
  • De schijf staat nog als unused0. Dan heb je de import gedaan, maar qm set 100 --scsi0 overgeslagen. De VM heeft dan geen opstartschijf.
  • De opstartvolgorde mist scsi0. Controleer de regel boot:. Daar moet order=scsi0 staan.
  • homeassistant.local werkt niet. Niet elk apparaat en niet elk netwerk kan .local-namen opzoeken. Zoek dan het IP-adres van de VM op in de lijst met apparaten van je router. Open daarna http://IP-ADRES:8123/.

Je Zigbee-, Z-Wave- of Thread-stick doorgeven

Je radiostick zit in de USB-poort van de mini-pc, dus Proxmox moet hem aan de VM doorgeven. Proxmox kent twee manieren om het apparaat aan te wijzen: op vendor-ID en product-ID, of op bus en poort van de host. Zoek eerst de gegevens op met lsusb op de host.

lsusb
lsusb -t

lsusb toont per apparaat een ID in de vorm 0123:abcd. Dat is de vendor-ID en de product-ID. lsusb -t toont de boomstructuur van bussen en poorten. Kies daarna een van de twee vormen.

# Op ID: dit apparaat, in welke poort het ook zit
qm set 100 --usb0 host=0123:abcd

# Op poort: wat er in deze fysieke poort van de host zit
qm set 100 --usb0 host=1-2.3.4

Het verschil zit in wat de regel aanwijst. Een ID-regel wijst het apparaat aan, dus de stick mag in een andere poort. Een poortregel wijst de fysieke poort aan, dus elk apparaat in die poort gaat naar de VM. Hebben twee sticks precies hetzelfde ID, dan kan een ID-regel ze niet uit elkaar houden. Gebruik dan per stick een poortregel. De nummering van de poorten hangt af van de volgorde van de USB-controllers in de host. Volgens de Proxmox-documentatie geeft Proxmox het apparaat door zodra het apparaat of de poort op de host beschikbaar is.

Een P1-kabel voor je slimme meter is ook een USB-apparaat. Die geef je op dezelfde manier door, met een tweede regel zoals --usb1.

De ZHA-documentatie van Home Assistant geeft nog twee adviezen voor Zigbee-sticks. Gebruik in Home Assistant het pad onder /dev/serial/by-id/ en niet een naam als /dev/ttyUSB0. Steek de stick in een USB 2.0-poort, of gebruik een USB 2.0-hub met eigen voeding of een afgeschermde verlengkabel.

Back-ups: wat Home Assistant terugzet en wat Proxmox terugzet

Er zijn twee soorten back-ups, en ze zetten niet hetzelfde terug.

Een back-up van Home Assistant zelf is een versleuteld .tar-bestand. Een volledige back-up bevat alle onderdelen, tenzij je de geschiedenis uitsluit. Je zet zo'n back-up terug op het huidige systeem, of tijdens de onboarding op een nieuw of teruggezet apparaat. Dat apparaat mag een ander type zijn. Een back-up uit deze VM werkt dus ook op andere hardware. Voor een versleutelde back-up heb je de sleutel uit de emergency kit nodig. Bewaar die sleutel buiten Home Assistant.

Een back-up van Proxmox met vzdump is altijd een volledige back-up van de VM: de configuratie en alle schijven. Daar horen ook de EFI-schijf en de HAOS-schijf met alles erop bij. Je zet de hele VM terug met qmrestore, maar dan wel op een Proxmox-host.

vzdump 100 --mode snapshot --storage local

De modus snapshot is de standaard. De VM blijft draaien, met de kortste onderbreking. Volgens de documentatie is er wel een klein risico op inconsistentie. Omdat de guest agent aanstaat, vraagt Proxmox HAOS om het bestandssysteem even te bevriezen en daarna weer vrij te geven. Dat verbetert de consistentie. Kies bij --storage een opslag die back-ups mag bevatten. pvesm status toont welke opslag er is.

Gebruik ze allebei. De vzdump is de snelste weg terug na een mislukte update van de VM. De back-up van Home Assistant is je weg naar nieuwe hardware. Home Assistant raadt aan om een kopie buiten Home Assistant te bewaren, en liefst ook een kopie op een andere plek. Die andere plek kan een VPS zijn: Proxmox Backup Server op een VPS bewaart je VM-back-ups buiten je huis.

Het community-script: sneller, maar lees het eerst

Het project community-scripts/ProxmoxVE is de voortzetting van de scripts van tteck. Het heeft een script dat een HAOS-VM voor je maakt. De README op GitHub zegt zelf: "These commands run as root on your host." Lees het script ook echt voordat je het plakt, zoals de README vraagt. Het draait als root op je Proxmox-host.

Op 19 november 2026 doet vm/haos-vm.sh in grote lijnen hetzelfde als de handmatige stappen hierboven. Het leest de versie van het gekozen kanaal (stable, beta of dev) uit de versiegegevens van Home Assistant. Het downloadt de bijbehorende haos_ova-image en pakt die uit. Het maakt een VM met OVMF, machinetype q35, de guest agent en virtio-scsi-pci. Het importeert de schijf op scsi0, zet de opstartvolgorde en zet automatisch starten aan. De EFI-schijf maakt het met efitype=4m, zonder een expliciete optie voor pre-enrolled-keys.

Let op één tegenstrijdigheid. De scriptpagina op community-scripts.org zegt op 19 november 2026 dat de VM "an installer image" start, en dat je de installatie in de console afmaakt. Het script zelf importeert de kant-en-klare HAOS-schijf en geen installer. Lees dus de pagina en het script op de dag dat je het gebruikt, want beide veranderen vaak. Na het script geldt dezelfde controlelijst als hierboven: qm config moet bios: ovmf en boot: order=scsi0 tonen.

De handmatige route kost een paar minuten meer. Daar staat tegenover dat je elke regel kent. Zit je vast, dan weet je welke instelling je moet controleren.

Hoort Home Assistant op een VPS?

Nee. Home Assistant hoort op hardware bij je thuis, naast je radio's en in je lokale netwerk. De Zigbee-stick, de P1-kabel en de Thread-radio zitten fysiek in die mini-pc. Lokale detectie van apparaten zoekt in je eigen netwerk. Een gehuurde server in een datacenter heeft geen van beide. Wat het verschil tussen Proxmox thuis en een VPS in de praktijk betekent, lees je in een aparte gids.

Een VPS heeft wel twee nuttige taken naast je Home Assistant. Hij bewaart de back-up buiten je huis, zoals hierboven beschreven. En hij kan dienen als relay voor toegang van buitenaf, bijvoorbeeld met een eigen Headscale-server als Tailscale-coördinatieserver.

Wat je daarna met HAOS kunt

Omdat je HAOS draait, vind je de app-winkel nu onder Settings > Apps > Install app (de menunamen uit de Engelse documentatie). De Tailscale-app is een community-app, onderhouden door core-ontwikkelaar Frenck van Home Assistant. Daarmee voeg je Home Assistant toe aan je tailnet en bereik je het van buitenaf. Die app kun je alleen gebruiken omdat je HAOS hebt gekozen, want Container heeft geen apps. Wil je daarna een AI-assistent je huis laten bedienen, lees dan hoe je Claude via MCP met Home Assistant verbindt.

FAQ

Kan Home Assistant in een LXC-container op Proxmox draaien?

Alleen als Home Assistant Container, dus Home Assistant in Docker binnen de LXC. Die methode heeft geen Supervisor en geen apps. De oude methoden Core en Supervised worden sinds release 2025.12 niet meer ondersteund. De installatiepagina's van Home Assistant noemen ook geen LXC-methode. Wil je apps zoals Tailscale, draai dan Home Assistant OS in een VM.

Geef ik mijn Zigbee-stick door op ID of op poort?

Proxmox kent beide. Een regel op vendor-ID en product-ID, zoals host=0123:abcd, wijst het apparaat aan, in welke poort het ook zit. Een regel op bus en poort, zoals host=1-2.3.4, wijst de fysieke poort aan. Hebben twee sticks hetzelfde ID, gebruik dan poortregels. Gebruik in Home Assistant het pad onder /dev/serial/by-id/ en steek een Zigbee-stick in een USB 2.0-poort.

Is de Proxmox VE-integratie in Home Assistant een HACS-integratie?

Nee. De Proxmox VE-integratie staat in de officiële lijst met integraties van Home Assistant, en de code staat in de core-repository. Je hebt dus geen HACS nodig. Met de integratie volg je je Proxmox-nodes, VM's en containers vanuit Home Assistant.

Hoeveel geheugen en hoeveel CPU heeft een HAOS-VM nodig?

De Linux/KVM-pagina van Home Assistant noemt als minimum 2 GB RAM en 2 vCPU's. Het voorbeeld op dezelfde pagina gebruikt 4096 MB, en deze handleiding gebruikt die waarde ook. Meer geheugen geef je later met bijvoorbeeld qm set 100 --memory 6144, gevolgd door een herstart van de VM.

Was dit artikel nuttig?

#home-assistant#proxmox#virtualization#lxc#self-hosting#zigbee