# HomeAssistant/ — pfv-bms operational notes

**Config source of truth: [KNEL/pfv-bms](https://git.knownelement.com/KNEL/pfv-bms)**
(private). Everything live (YAML, dashboards, packages) is deployed by
pushing that repo — the `core_git_pull` add-on on pfv-bms polls every 300s,
pulls, and auto-restarts Home Assistant on config changes.

## Where things live

| Thing | Location |
|---|---|
| HA configuration (live) | KNEL/pfv-bms repo → /config on pfv-bms (VM 100, pfv-tsys1, 4 vCPU / 6GB) |
| Deploy pipeline | core_git_pull add-on (deploy key `~/.creds/pfv-bms-gitpull`, read-only) |
| Host shell access | `VM_IP=pfv-bms-lan.knel.net VM_USER=root VM_PORT=22222 bash tests/remote.sh vm '...'` |
| HA REST API | `~/.creds/homeassistant.env` (token) |
| Global/Cloudron instance | https://building-management.knownelement.com (`~/.creds/cloudron-ha.env`) |
| Samba (interactive edits) | add-on; creds `~/.creds/pfv-bms-samba.env` |
| Custom components | on-box only, gitignored (HACS 2.0.5, Govee lasswellt v2026.8.7) |
| Reference packs (this dir) | `packs/` — see statuses below |

## packs/ status

| File | Status |
|---|---|
| automations-ups-alerts.yaml | SUPERSEDED — live copy in KNEL/pfv-bms (retargeted to companion app) |
| sensors-snmp-plant.yaml | DEAD — legacy snmp sensor platform creates nothing in HA 2026.8; migration tracked in #618 |
| energy-plant-kwh.yaml | PENDING — Riemann-sum helper reference for the energy dashboard (#439) |

## Related tickets

#344 (umbrella) · #439 (UPS/alerts) · #614 (minisplit/BTU) · #618-#628 (roadmap) · #629 (Friday onsite)

Knowledge docs live on
[Discourse VP TechOps](https://community.turnsys.com/c/vp-techops) — this
file is the repo-side operational pointer.