Home Assistant

Runs as a KVM virtual machine on Agap.

Install libvirt

sudo apt update
sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils virt-manager

Download Image

Download HAOS for KVM

Extract and move:

xz -d haos_ova-*.qcow2.xz
mv haos_ova-*.qcow2 /var/lib/libvirt/images/

Install VM

virt-install \
  --name haos \
  --description "Home Assistant OS" \
  --os-variant=ubuntu24.04 \
  --ram=4096 \
  --vcpus=2 \
  --disk /var/lib/libvirt/images/haos_ova-16.2.qcow2,bus=scsi \
  --controller type=scsi,model=virtio-scsi \
  --import \
  --graphics none \
  --boot uefi \
  --network bridge=br0

Post-install

If boot fails, disable Secure Boot in UEFI firmware settings (reference)
Find assigned IP at router admin panel

Zabbix Alerting

HA pushes alerts to Zabbix via rest_command → Zabbix history.push API (trapper items).

Water Leak Sensors

3x HOBEIAN ZG-222Z Zigbee moisture sensors:

Entity	Room
`binary_sensor.hobeian_zg_222z`	Kitchen
`binary_sensor.hobeian_zg_222z_2`	Bathroom
`binary_sensor.hobeian_zg_222z_3`	Laundry

Sensor ON → automation sends room name to Zabbix trapper item water.leak on host "HA Agap"
Zabbix trigger fires Disaster alert: "Water leak detected in {room}"
All sensors OFF → automation sends "ok" to clear

Config: rest_command entries in configuration.yaml, automations water_leak_alert and water_leak_clear.