Gooi Google Home voorgoed weg: installeer Home Assistant OS op Proxmox en houd elke byte lokaal

Gooi Google Home voorgoed weg: installeer Home Assistant OS op Proxmox en houd elke byte lokaal

Deze guide legt uit hoe je Home Assistant OS installeren op Proxmox aanpakt als volledige virtuele machine via het community helper script. Elke keer dat je Google Home vraagt om je lampen te dimmen, reist dat commando naar een server in de Verenigde Staten, wordt het daar verwerkt en komt het antwoord terug. Je aanwezigheidspatronen, temperatuurschema’s en bewegingssensordata verlaten continu je woning. Voor EU-inwoners botst dit rechtstreeks met de GDPR-principes rondom dataminimalisatie en opslaglocatie. Met Home Assistant OS dat lokaal op Proxmox draait, verlaat er geen enkele sensordata je netwerk. Je slimme woning blijft bovendien volledig functioneren tijdens een internetstoring. Dit is de enige configuratie die wij bij DomoticaPlatform aanraden.

Welke data je woning verlaat via cloud-smarthomeplatformen

• Spraakopdrachten en de bijbehorende tijdstempels
• Activeringspatronen van bewegingssensoren (welke ruimtes, op welke tijden)
• Temperatuur- en luchtvochtigheidsmeetwaarden
• Aanwezigheidsschema’s afgeleid van sensoractiviteit
• Statuswijzigingen van apparaten (lampen aan/uit, sloten vergrendeld)

Dit alles gaat naar servers van derden, voornamelijk in de Verenigde Staten, onder het privacybeleid van Google, Amazon of Apple.

Wat deze guide wel en niet behandelt

Deze guide behandelt één specifieke installatiemethode: Home Assistant OS (HAOS) als volledige virtuele machine binnen Proxmox VE, via het community helper-script. We behandelen geen Home Assistant Container, Home Assistant Core of bare-metal installaties op een Raspberry Pi.

Een veelgestelde vraag op Reddit is: “Heb ik het helper-script eigenlijk wel nodig?” Het antwoord is ja. Het helper-script installeert HAOS, inclusief de Supervisor. De Supervisor is de beheerlaag die de Add-on Store aanstuurt. Zonder de Supervisor kun je geen add-ons met één klik installeren, zoals Zigbee2MQTT, ESPHome of de NGINX proxy manager. Je zou elke integratie als een aparte, handmatig bij te werken service moeten beheren. Het helper-script is geen sluiproute — het is gewoon de juiste installatiemethode.

Home Assistant OS installeren op Proxmox: vereisten en hardware

Wat je nodig hebt voordat je ook maar één commando uitvoert

• Een werkende Proxmox VE-server (elke recente versie)
• Minimaal 2 vCores toegewezen (4 vCores aanbevolen bij zware automatiseringen)
• Minimaal 4 GB RAM toegewezen (8 GB aanbevolen)
• Minimaal 64 GB snelle opslag, uitsluitend SSD of NVMe — absoluut geen harde schijven
• Toegang tot je router om een vast IP-adres in te stellen

Een noot over opslag: de grootste fout die nieuwe gebruikers maken

Het helper-script gaat standaard uit van een schijf van 32 GB. Dat klinkt redelijk, totdat je ziet wat HAOS daadwerkelijk opslaat: een recorder-database die elke statuswijziging van elke sensor bijhoudt, lokale back-ups, systeemlogboeken en add-on-data. Gebruikers op Reddit melden consequent dat de schijf binnen twee tot vier weken vol zit bij de standaard 32 GB. Gebruik 64 GB als minimum. Gebruik 128 GB als je meerdere add-ons draait en een lange recorder-geschiedenis bijhoudt.

Methode 1: De snelle start (het pad voor beginners)

Twee opties voor beginners, en waarom we je van één ervan afraden

Optie A: Koop een Home Assistant Green

De Home Assistant Green is een plug-and-play hardware-apparaat. Je sluit het aan, verbindt het met je netwerk en volgt de installatiewizard. Geen Proxmox nodig, geen commandoregel, geen configuratiebestanden. Het wordt officieel ondersteund door Nabu Casa, het bedrijf achter Home Assistant.

De keerzijde is flexibiliteit. De Green draait uitsluitend Home Assistant. Je kunt er geen Jellyfin, Nextcloud of andere zelfgehoste diensten naast draaien op dezelfde hardware. Als je een dedicated, onderhoudsvrije smarthome-hub wilt en verder niets, is dit een valide keuze.

Optie B: Home Assistant als Docker-container

• Geen Supervisor-laag
• Geen Add-on Store (geen Zigbee2MQTT met één klik, geen ESPHome met één klik)
• USB-antenne doorgeven aan de container wordt een handmatige configuratienachtmerrie
• Elke toekomstige integratie-update vereist handmatig afhankelijkheidsbeheer
• Geen ingebouwd back-upsysteem beheerd door de Supervisor

Als je al Proxmox draait, sla beide opties hierboven over en ga direct naar Methode 2.

Wanneer Methode 1 wél zinvol is

• Je hebt geen Proxmox-server en bent niet van plan er een te bouwen
• Je wilt nul onderhoudswerk en een ondersteund apparaat
• Je test Home Assistant voordat je een volledige hardware-investering doet

Methode 2: De pro-opstelling (volledige HAOS VM op Proxmox)

Dit is de standaard voor self-hosters. HAOS draait als volledige virtuele machine, wat je de complete Supervisor, de volledige Add-on Store en nette isolatie van je andere Proxmox-workloads geeft. Als je al een Proxmox-server hebt draaien met diensten zoals Jellyfin of Nextcloud, is HAOS als VM toevoegen de logische volgende stap.

Stap 1: Open de Proxmox-shell

1. Open de Proxmox-webinterface in een browser.
2. Klik in de linker zijbalk op je primaire node. De standaardnaam is pve.
3. Klik op Shell rechtsboven in de node-weergave. Dit opent de Proxmox-hostconsole direct.

Zorg dat je in de node-shell zit, niet in een VM-console of LXC-console. De prompt toont je Proxmox-hostnaam, niet een VM-naam.

Stap 2: Voer het community helper-script uit

Het Proxmox VE Helper Scripts-project, beheerd als community-scripts op GitHub, is de community-standaard voor het installeren van HAOS op Proxmox. Het regelt het downloaden van het image, het aanmaken van de VM en de eerste opstart automatisch.

Een veelvoorkomende verwarring op Reddit: gebruik haos-vm.sh, niet de verouderde haos.sh. De oude URL geeft een stille 404 terug en er gebeurt niets. Gebruik exact dit commando:

bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/vm/haos-vm.sh)"

Plak dit in de Proxmox-shell en druk op Enter. Als er niets gebeurt en de prompt direct terugkeert zonder uitvoer, raadpleeg dan de sectie Probleemoplossing hieronder. Je gebruikt waarschijnlijk de verkeerde URL of zit in de verkeerde shell.

Stap 3: Kies Advanced, niet Default

Wanneer het script start, toont het een menu. Selecteer Advanced om alle parameters zelf in te stellen voordat de VM wordt aangemaakt.

Stap 4: Stel de VM-parameters correct in

Gebruik bij de Advanced-configuratieprompts de volgende waarden:

Neem de tijd bij het selecteren van de opslagpool. Als je meerdere pools hebt, controleer dan welke door SSD of NVMe wordt ondersteund voordat je het script uitvoert. Dit kun je nakijken in de Proxmox-interface onder Datacenter > Storage.

Stap 5: Laat het script de VM bouwen en opstarten

Nadat je je configuratie bevestigt, neemt het script het volledig over. Het zal:

1. Het nieuwste HAOS-schijfimage direct downloaden van de Home Assistant-releaseservers
2. De VM aanmaken met de door jou opgegeven parameters
3. Het schijfimage importeren in je geselecteerde opslagpool
4. De VM automatisch starten

Reken op twee tot vijf minuten, afhankelijk van je internetsnelheid en de schrijfsnelheid van je opslag. Je ziet voortgangsuitvoer in de terminal. Een geslaagde uitvoering eindigt met de VM in draaiende toestand en een bevestigingsmelding.

Configuratie en validatie: bevestig dat alles werkt

Stap 1: Lees het IP-adres af uit de VM-console

1. Zoek je nieuwe VM in de linker zijbalk van Proxmox.
2. Klik erop en klik vervolgens op het tabblad Console.
3. Wacht ongeveer 60 seconden totdat HAOS volledig is opgestart. Je ziet opstartmeldingen voorbijkomen.
4. Na het opstarten toont de console het toegewezen IP-adres. Dat ziet er ongeveer uit als 10.10.10.x of 192.168.1.x, afhankelijk van je netwerk.

Schrijf dit IP-adres op. Je hebt het nodig voor de volgende twee stappen.

Stap 2: Stel een vast IP-adres in via de routerconfiguratie

De exacte stappen verschillen per routermerk, maar het proces is universeel:

1. Log in op het beheerpaneel van je router (doorgaans op 192.168.1.1 of 192.168.0.1).
2. Zoek de DHCP-reserveringstabel of tabel met vaste leases. Deze kan “Address Reservation”, “Static DHCP” of “DHCP Binding” heten, afhankelijk van je router.
3. Zoek het MAC-adres van de HAOS VM. Dit vind je in Proxmox onder het tabblad Hardware van je VM, bij het netwerkapparaat.
4. Maak een reservering aan die dat MAC-adres koppelt aan het IP-adres dat je in de console hebt gezien.
5. Sla de instellingen op en pas ze toe.

Stap 3: Doorloop de Home Assistant-installatiewizard

1. Open een browser op een apparaat in je lokale netwerk.
2. Navigeer naar:

http://[JOUW-IP-ADRES]:8123

3. De Home Assistant-installatiewizard laadt. Maak je beheerdersaccount aan met een sterk, uniek wachtwoord. Hergebruik geen wachtwoord van een andere dienst.
4. Stel je thuislocatie nauwkeurig in. Home Assistant gebruikt dit voor zonsopgang- en zonsondergangautomatiseringen. Een onjuiste locatie betekent dat je lampen elke dag op het verkeerde moment aangaan.
5. Rond de wizard af en bevestig dat het hoofddashboard zonder fouten laadt.

Validatiechecklist

Bevestig elk punt hieronder voordat je verdergaat:

• HAOS VM staat als actief vermeld in de Proxmox VM-lijst
• Console toont een geldig lokaal IP-adres
• Vast IP-adres ingesteld in de router voor dat IP
• Home Assistant-interface bereikbaar op http://[IP]:8123
• Beheerdersaccount aangemaakt met een sterk wachtwoord
• Thuislocatie correct ingesteld tijdens de onboarding

De eerlijke afwegingen: wat een volledige VM je kost ten opzichte van Docker

Wat je inlevert

• RAM-overhead: Een VM reserveert permanent het toegewezen geheugen. Als je 8 GB toewijst, zijn die 8 GB niet beschikbaar voor je Proxmox-host en andere VM’s, ook niet wanneer HAOS niets doet. Een Docker-container deelt het hostgeheugen efficiënter.
• Opstarttijd: Een koude start van een VM duurt 45 tot 90 seconden. Een Docker-container start in minder dan 5 seconden.
• Schijfruimte: Een volledig VM-image neemt meer ruimte in beslag dan een containerbestandssysteem.

Waarom je die kosten toch moet accepteren

De Supervisor en de Add-on Store zijn onmisbaar voor een beheersbare slimme woning. Zonder die laag update je elke integratie handmatig, beheer je afhankelijkheden handmatig en configureer je USB-antennedoorvoer handmatig elke keer dat een driver wijzigt. De r/homeassistant-community raadt HAOS consequent aan boven Container voor elke primaire installatie, en de redenering is steeds dezelfde: de onderhoudslast van een Container-installatie stapelt zich elke maand verder op.

De hardware-investering verdient zichzelf terug in uren die je per maand bespaart. Dit is de enige configuratie die wij bij DomoticaPlatform aanraden aan iedereen die een slimme woning bouwt die ze op de lange termijn willen onderhouden.

Probleemoplossing bij veelvoorkomende fouten

Fout: script start niet na plakken in de shell

Symptoom: Er gebeurt niets na het drukken op Enter, of de terminal keert direct terug naar de prompt zonder uitvoer.

Oorzaak: Je gebruikt de verouderde haos.sh-URL, die een stille 404 teruggeeft, of je plakt het commando in een VM-console in plaats van de Proxmox-node-shell.

Oplossing: Controleer of je commando exact haos-vm.sh gebruikt zoals hieronder weergegeven, en bevestig dat je in de Proxmox-node-shell zit (de prompt toont je Proxmox-hostnaam).

bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/vm/haos-vm.sh)"

Fout: Home Assistant is extreem traag, grafieken laden niet

Symptoom: De interface reageert pas na 10 seconden of meer. Historiekgrafieken lopen vast of worden nooit weergegeven. Het systeem voelt traag aan, zelfs met weinig verbonden apparaten.

Oorzaak: Tijdens de Advanced-configuratiestap heb je een opslagpool op een harde schijf geselecteerd in plaats van een SSD- of NVMe-pool. HAOS schrijft continu sensorstatusdata naar schijf. Een draaiende harde schijf kan dit schrijfpatroon niet bijhouden.

Oplossing: Hier is geen patch voor. Je moet de VM opnieuw opbouwen. Verwijder de bestaande VM, voer het helper-script opnieuw uit en selecteer tijdens de Advanced-configuratiestap expliciet je SSD- of NVMe-pool.

Fout: Home Assistant niet bereikbaar na herstart van de router

Symptoom: http://[IP]:8123 geeft een verbindingsfout of time-out na het herstarten van je router.

Oorzaak: Je router heeft na de herstart via DHCP een nieuw IP-adres aan de HAOS VM toegewezen. Het IP-adres dat je als bladwijzer hebt opgeslagen, verwijst niet meer naar je Home Assistant-instantie.

Oplossing: Stel een vast IP-adres in via je router zoals beschreven in de sectie Configuratie en validatie hierboven. Als extra beveiligingslaag kun je ook een vast IP instellen rechtstreeks in Home Assistant via Instellingen > Systeem > Netwerk. Beide methoden samen gebruiken betekent dat het IP-adres ook behouden blijft als je routerconfiguratie wordt gereset.

Conclusie en vervolgstappen: je smarthome-fundament is live

Wat je hebt gebouwd

• Home Assistant OS (HAOS) draait als volledige VM op Proxmox
• Voldoende RAM en snelle SSD/NVMe-opslag (minimaal 64 GB) toegewezen
• Vast netwerk-IP-adres ingesteld via de router
• Eerste beheerdersaccount en thuislocatie-onboarding afgerond

Je hebt nu een volledig lokaal smarthome-fundament zonder enige cloudafhankelijkheid. Elke byte blijft op jouw hardware, op jouw netwerk, onder jouw beheer.

Wat er nu komt: de server draait, maar is doof en blind

HAOS draait, maar heeft momenteel geen manier om te communiceren met je fysieke slimme apparaten. Het kan je Zigbee-lampen, je Z-Wave-deursensoren of je slimme energiemeter niet zien. De volgende twee stappen in je opbouw zijn:

1. USB-doorvoer in Proxmox: Een Zigbee- of Z-Wave-USB-dongle (een dual-chip antenne) fysiek doorgeven aan de HAOS VM, zodat die kan communiceren met je draadloze apparaten. Zonder deze stap is je slimme thuishardware onzichtbaar voor Home Assistant.
2. Lokale netwerkapparaatdetectie: Apparaten ontdekken en integreren die al op je lokale netwerk zitten, zoals een slimme P1-energiemeter of lokale Wi-Fi-sensoren. Home Assistant detecteert veel van deze apparaten automatisch zodra het draait.

We behandelen beide onderwerpen in de volgende guides in deze reeks. Je fundament staat stevig. Nu maken we het nuttig.