docs(ha): relocated to lizacer; remove KVM-on-Agap install instructions
@@ -1,63 +1,25 @@
|
|||||||
# Home Assistant
|
# 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
|
- **Host:** lizacer (`192.168.1.4`)
|
||||||
sudo apt update
|
- **Form:** Docker container (`ghcr.io/home-assistant/home-assistant:stable`)
|
||||||
sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils virt-manager
|
- **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
|
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.
|
||||||
xz -d haos_ova-*.qcow2.xz
|
|
||||||
mv haos_ova-*.qcow2 /var/lib/libvirt/images/
|
|
||||||
```
|
|
||||||
|
|
||||||
## Install VM
|
## Zabbix alerting
|
||||||
|
|
||||||
```bash
|
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.
|
||||||
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
|
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.
|
||||||
|
|
||||||
- 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`.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user