alvis/AgapHost
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(ha): relocated to lizacer; remove KVM-on-Agap install instructions

alvis
2026-05-22 14:14:50 +00:00
parent ffcdf525b5
commit b72f51f90d
1 changed files with 25 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
Home-Assistant.md

@@ -1,63 +1,25 @@
# Home Assistant
Runs as a KVM virtual machine on Agap.
**Relocated to lizacer on 2026-05-22.** Home Assistant no longer runs on Agap.
## Install libvirt
## Current location
```bash
sudo apt update
sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils virt-manager
```
- **Host:** lizacer (`192.168.1.4`)
- **Form:** Docker container (`ghcr.io/home-assistant/home-assistant:stable`)
- **API:** `http://192.168.1.4:8123`
- **Public URL:** `https://haos.alogins.net`
## Download Image
Co-located on lizacer:
[Download HAOS for KVM](https://www.home-assistant.io/installation/linux/)
- `zigbee2mqtt` — Zigbee bridge (replaces the previous Sonoff dongle / ZHA setup)
- `mosquitto` — MQTT broker for zigbee2mqtt ↔ HA
Extract and move:
## What was on Agap
```bash
xz -d haos_ova-*.qcow2.xz
mv haos_ova-*.qcow2 /var/lib/libvirt/images/
```
A HAOS KVM VM (`haos_ova-17.1.qcow2`, 4 GB RAM, 2 vCPU, br0 bridge, UEFI). The VM and its disk image were removed via `virsh undefine haos --nvram --remove-all-storage` on 2026-05-22.
## Install VM
## Zabbix alerting
```bash
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
```
HA still pushes alerts to Zabbix via `rest_command` → trapper items on the Zabbix host **HA Agap** (host name is legacy — not renamed yet). Water leak, motion, and device-availability automations are owned by the HA config on lizacer.
## Post-install
- If boot fails, disable Secure Boot in UEFI firmware settings ([reference](https://www.reddit.com/r/homeassistant/comments/198yg1a/trying_to_install_ha_as_a_virtual_machine_in/))
- 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`.
Entity IDs that started as ZHA (`binary_sensor.0xa4c1...`, `binary_sensor.hobeian_zg_222z*`) may have changed after the zigbee2mqtt migration. Verify before relying on names in new automations or Zabbix items.