Communityoplossing

Draai Home Assistant volledig met add-ons op ZimaOS

A January 2026 ZimaOS discussion clarified that Home Assistant features depend on the installation type, not the ZimaOS version. Docker provides Home Assistant Container without Supervisor/add-ons, while one user confirmed full Home Assistant OS running inside ZVM.

Als je de ‘volledige’ Home Assistant-ervaring wilt met Supervisor, apps/add-ons, back-ups en door Home Assistant beheerde updates, is de belangrijkste keuze het installatietype van Home Assistant, niet een specifieke ZimaOS-versie. Dat was het centrale antwoord in de IceWhale Community-thread van januari 2026.

Home Assistant Container kan normaal als Docker-applicatie op ZimaOS draaien, maar de huidige Home Assistant-documentatie vermeldt expliciet dat de Container-installatie geen toegang heeft tot Home Assistant-apps. Als je ZimaOS wilt behouden en toch de volledige HAOS-ervaring wilt, is de best onderbouwde oplossing volgens de bronnen om Home Assistant Operating System als virtuele machine uit te voeren. Een communitygebruiker bevestigde dit binnen ZVM te hebben gedaan en meldde toegang tot HACS en add-ons.

De drie praktische Home Assistant-opties

Methode Behoudt ZimaOS? Supervisor / Apps Ideaal voor
Home Assistant Container in ZimaOS Ja Nee Gebruikers die hun ondersteunende containers graag zelf beheren
Home Assistant OS in ZVM Ja Ja Volledige HA-ervaring met behoud van ZimaOS
Home Assistant OS bare metal Nee, als dit op dezelfde schijf is geïnstalleerd Ja Speciaal Home Assistant-apparaat

Optie 1: Home Assistant Container op ZimaOS

Als je Home Assistant via Docker op ZimaOS installeert, gebruik je Home Assistant Container. Dit biedt Home Assistant Core in een container en is een officieel ondersteund installatietype van Home Assistant.

De huidige Home Assistant-documentatie is expliciet:

  • Home Assistant Container draait in Docker of een andere OCI-compatibele runtime.
  • Het bevat de Home Assistant Supervisor niet.
  • Het biedt geen Home Assistant-apps/add-ons.
  • Je beheert ondersteunende services en updates zelf.

Huidige referentie: installatiehandleiding voor Home Assistant Generic x86-64.

‘Geen add-ons’ betekent niet dat je MQTT, ESPHome of andere services niet kunt uitvoeren

Veel Home Assistant-add-ons zijn wrappers rond software die ook als normale Docker-containers bestaat. Met Home Assistant Container op ZimaOS kun je services zoals MQTT-brokers, ESPHome, Node-RED of databases vaak als afzonderlijke containers uitvoeren.

Het verschil zit in het beheer: Home Assistant Supervisor zal die containers niet installeren, bijwerken, monitoren, back-uppen of als Home Assistant-add-ons integreren. Je wordt zelf verantwoordelijk voor hun Docker-levenscyclus.

Optie 2: Home Assistant OS als VM uitvoeren in ZVM

Een latere reactie in de brondraad gaf het nuttigste ZimaOS-specifieke antwoord. Communitylid ZimaRat zei dat die een virtuele-machine-image van Home Assistant had gedownload, naar ZimaOS had gekopieerd, ZVM had geopend, Aangepaste installatie had geselecteerd, de image uit ZimaOS Files had gekozen en Home Assistant OS als VM had opgestart.

Ze meldden dat ze na de initialisatie van HAOS HACS en add-ons konden installeren. Een ander ervaren communitylid bevestigde dat dit een geldige manier was om ZimaOS te behouden en toch de volledige HAOS-ervaring te krijgen.

Waarom de VM-methode de volledige Home Assistant-ervaring biedt

Home Assistant OS is een compleet appliance-besturingssysteem. Wanneer het binnen een hardware-VM draait, beheert het nog steeds zijn eigen virtuele schijf en de Home Assistant Supervisor-omgeving.

Dat verschilt fundamenteel van het uitsluitend starten van de Home Assistant-toepassing als Docker-container binnen ZimaOS.

De huidige documentatie van Home Assistant ondersteunt HAOS officieel als virtuele machine op ondersteunde hypervisors en biedt images zoals:

  • VirtualBox .vdi;
  • KVM/Proxmox .qcow2;
  • VMware .ova.

Officiële referentie: Installatiehandleiding voor Home Assistant OS als virtuele machine.

De brongebruiker gebruikte een VirtualBox-image in ZVM

In de communityreactie werd specifiek vermeld dat men de VirtualBox-image van de pagina voor alternatieve installaties van Home Assistant gebruikte, deze uitpakte, naar ZimaOS kopieerde en vanuit ZVM selecteerde.

Dat is een bevestigd resultaat uit de community voor hun ZVM-versie uit 2026. Je moet dit niet veralgemenen tot de bewering dat elke toekomstige ZVM-build elk Home Assistant-imageformaat ongewijzigd ondersteunt. Gebruik bij het aanmaken van een nieuwe VM een imageformaat dat door je huidige ZVM-interface wordt geaccepteerd.

Vereisten voor VM-resources

De huidige VM-handleiding van Home Assistant vermeldt als minimum:

2 GB RAM
2 vCPU's

Wijs meer resources toe als je zwaardere add-ons, spraakverwerking, databases, camera's of grote automatiseringsworkloads wilt gebruiken.

Houd voldoende CPU- en geheugenresources beschikbaar voor ZimaOS en de andere toepassingen, in plaats van alle hostresources aan de HAOS-VM toe te wijzen.

Zigbee-, Z-Wave- en USB-radio's vereisen passthrough

De bronreacties merkten terecht een compromis van HAOS in ZVM op: fysieke USB-apparaten, zoals Zigbee- of Z-Wave-coördinators, moeten aan de VM worden doorgegeven.

Als de radio niet zichtbaar is binnen HAOS, kan Home Assistant deze niet gebruiken, ook al detecteert ZimaOS het USB-apparaat wel op de host.

Controleer voordat je voor het VM-ontwerp kiest of je huidige ZVM-versie de USB-doorvoer ondersteunt die je automatiseringshardware nodig heeft.

Optie 3: Vervang ZimaOS door Home Assistant OS

Als de mini-pc volledig voor Home Assistant is bestemd, biedt HAOS rechtstreeks op de hardware installeren de eenvoudigste volledige Home Assistant-omgeving.

De oorspronkelijke discussie beschreef de installatie echter aanvankelijk te simplistisch als “flash HAOS naar USB en installeer het”. Een latere gebruiker wees er terecht op dat HAOS geen traditioneel installatieprogramma biedt dat vanaf USB opstart en zichzelf naar de interne schijf schrijft.

In de huidige Home Assistant-documentatie staat:

HAOS heeft geen geïntegreerd installatieprogramma dat de image automatisch schrijft.

Voor generieke x86-64-hardware is de aanbevolen methode om op te starten vanaf een live-Ubuntu-USB-stick en het hulpprogramma Schijven te gebruiken om de HAOS-schijfimage naar de interne doelschijf te herstellen. Een andere methode is om de HAOS-schijfimage vanaf een andere computer rechtstreeks naar het beoogde opstartmedium te schrijven.

HAOS installeren op de ZimaOS-schijf wist ZimaOS

Home Assistant OS is zelf een besturingssysteem. Als je de HAOS-image naar de fysieke schijf schrijft waarop momenteel Windows of ZimaOS staat, worden het oude besturingssysteem en de gegevens op die doelschijf overschreven.

Maak eerst een back-up van je gegevens. Een installatie van de “Home Assistant-app” en een installatie van “Home Assistant OS” zijn volledig verschillende handelingen.

Kun je beide op afzonderlijke fysieke schijven behouden?

In de reacties van de community werd ook genoemd om één schijf voor ZimaOS en een andere voor Home Assistant OS te gebruiken en vervolgens het opstartapparaat in de firmware te selecteren. Daarmee voorkom je dat het andere besturingssysteem wordt overschreven, maar dit is niet hetzelfde als beide omgevingen tegelijkertijd actief hebben.

Als je zowel ZimaOS als een volledig werkende Home Assistant tegelijkertijd op één machine wilt gebruiken, is de HAOS-in-ZVM-aanpak praktischer.

Bare-metal HAOS kan hardware- en firmwarecompatibiliteitsverschillen vertonen

Een latere deelnemer meldde dat hij HAOS naar een externe NVMe-schijf voor een ZimaBoard had geschreven, maar op die hardware een kernel-offset-/opstartfout kreeg, hoewel dezelfde NVMe-schijf op een ander systeem wel opstartte.

De discussie leverde geen bevestigde universele oplossing op. Dat is een extra reden om bare-metal HAOS niet als gegarandeerd op elk x86-Zima-apparaat te beschrijven. UEFI, Secure Boot, opslagcontroller en firmwaregedrag zijn van belang.

Huidige vereisten voor HAOS Generic x86-64

De huidige handleiding van Home Assistant vereist:

  • een 64-bits Intel/AMD-systeem;
  • UEFI-opstartmodus;
  • Secure Boot uitgeschakeld;
  • een speciale opstartschijf of een speciaal opstartmedium;
  • netwerk-/internettoegang voor de eerste configuratie.

Nadat HAOS is gestart, is Home Assistant normaal gesproken beschikbaar op:

http://homeassistant.local:8123

of via het IP-adres van de VM of het apparaat op poort 8123.

Welke methode moet je kiezen?

Kies Home Assistant Container op ZimaOS als:

  • je al vertrouwd bent met Docker-beheer;
  • je geen door Supervisor beheerde add-ons nodig hebt;
  • je Home Assistant naast veel gewone ZimaOS-apps wilt gebruiken met minimale VM-overhead.

Kies Home Assistant OS in ZVM als:

  • je Supervisor en het Home Assistant-ecosysteem van add-ons/apps wilt;
  • je ZimaOS op dezelfde machine wilt blijven gebruiken;
  • je VM-resources wilt toewijzen en USB-apparaten wilt doorgeven.

Kies Home Assistant OS bare metal als:

  • de machine uitsluitend voor Home Assistant wordt gebruikt;
  • je ZimaOS niet op die machine nodig hebt;
  • je het eenvoudigste, officieel aanbevolen appliance-model voor Home Assistant wilt.

Checklist: volledige Home Assistant op ZimaOS

  1. Bepaal of je Supervisor/add-ons echt nodig hebt.
  2. Als dat niet zo is, kan Home Assistant Container in ZimaOS voldoende zijn.
  3. Als dat zo is en je ZimaOS wilt behouden, maak dan een HAOS-VM in ZVM.
  4. Gebruik een actuele Home Assistant OS-VM-image die door je VM-werkwijze wordt ondersteund.
  5. Wijs minimaal 2 GB RAM en 2 vCPU's toe, en meer voor zwaardere workloads.
  6. Geef Zigbee-, Z-Wave- en USB-apparaten door als Home Assistant ze nodig heeft.
  7. Gebruik de eigen back-upfunctie van HAOS binnen de VM.
  8. Als je HAOS bare metal installeert, moet je begrijpen dat het schrijven van de image het besturingssysteem op de doelschijf vervangt.

FAQ: volledige Home Assistant op ZimaOS

Welke ZimaOS-versie maakt Home Assistant-add-ons mogelijk?

Geen enkele specifieke ZimaOS-versie kan dat. De beschikbaarheid van add-ons hangt af van het gebruik van Home Assistant OS/Supervisor en niet van Home Assistant Container.

Kan de Home Assistant Docker-app op ZimaOS add-ons installeren?

Nee. Volgens de huidige Home Assistant-documentatie heeft de Container-installatie geen toegang tot Home Assistant-apps/add-ons.

Kan ZVM de volledige versie van Home Assistant uitvoeren?

De brondiscussie bevat een door een gebruiker bevestigde HAOS-in-ZVM-configuratie met HACS en add-ons. Beschouw dit als een door de community bevestigde ZimaOS-werkwijze en controleer of de huidige ZVM-image en USB-passthrough worden ondersteund.

Wist de installatie van Home Assistant OS ZimaOS?

Ja, als je HAOS naar dezelfde fysieke schijf schrijft waarop momenteel ZimaOS staat. Door HAOS in een VM uit te voeren, voorkom je die vervanging.