Files
homelab-optimized/docs/services/home-assistant/README.md
Gitea Mirror Bot 2ea7d71f94
Some checks failed
Documentation / Build Docusaurus (push) Failing after 5m3s
Documentation / Deploy to GitHub Pages (push) Has been skipped
Sanitized mirror from private repository - 2026-04-05 10:53:12 UTC
2026-04-05 10:53:12 +00:00

298 lines
12 KiB
Markdown

# 🏠 Home Assistant Configuration
This document covers all Home Assistant instances across the homelab, including automations, integrations, and configurations.
## Overview
| Instance | Location | Hardware | HA Version | Purpose |
|----------|----------|----------|------------|---------|
| **HA Green** | Honolulu, HI | Home Assistant Green | 2026.1.3 | Hawaii smart home control |
| **HA NUC** | Concord, CA | Intel NUC6i3SYB | TBD | Primary home automation hub |
---
## 🌺 Honolulu Instance (Home Assistant Green)
### Hardware Details
- **Device**: Home Assistant Green
- **CPU**: ARM Cortex-A55 (4-core)
- **RAM**: 4GB LPDDR4
- **Storage**: 32GB eMMC (8.2GB used, 31%)
- **Network**: 192.168.12.202/24
- **OS**: Home Assistant OS 6.12.63-haos
### Add-ons Installed
| Add-on | Purpose |
|--------|---------|
| **Matter Server** | Matter/Thread smart home protocol support |
| **Advanced SSH & Web Terminal** | Remote shell access |
### Custom Components (HACS)
| Component | Purpose |
|-----------|---------|
| **HACS** | Home Assistant Community Store |
| **Oura** | Oura Ring health/sleep tracking integration |
| **Tapo Control** | TP-Link Tapo camera PTZ control |
---
### 🤖 Automations
#### 1. Hawaii Living Room - Motion Lights On
**Purpose**: Automatically turn on living room lights when motion is detected in the evening.
```yaml
id: '1767509760079'
alias: Hawaii Living Room Camera Motion Turn On Lights
triggers:
- type: motion
device_id: b598fe803597a6826c0d1be292ea6990
entity_id: 600ef0e63bf50b958663b6602769c43d
domain: binary_sensor
trigger: device
conditions:
- condition: time
after: '16:00:00'
before: '01:00:00'
weekday: [sun, mon, tue, wed, thu, fri, sat]
actions:
- action: light.turn_on
target:
entity_id:
- light.hawaii_cocina_white_fan_2_bulbs
- light.hawaii_lightstrip
- light.hawaii_white_fan_1_bulb_2
- light.hawaii_pineapple_light_l535e
- light.hawaii_white_fan_1_bulb_2_2
mode: single
```
| Setting | Value |
|---------|-------|
| **Trigger** | Living room camera motion sensor |
| **Time Window** | 4:00 PM - 1:00 AM |
| **Days** | Every day |
| **Lights Controlled** | 5 (fan bulbs, lightstrip, pineapple lamp) |
---
#### 2. Hawaii Living Room - No Motion Lights Off
**Purpose**: Turn off living room lights after 20 minutes of no motion.
```yaml
id: '1767511914724'
alias: Hawaii Living Room Camera No Motion Turn Off Lights
triggers:
- type: no_motion
device_id: 6977aea8e1b5d86fa5fdb01618568353
entity_id: a00adebc3cff7657057b84e983f401e3
domain: binary_sensor
trigger: device
for:
hours: 0
minutes: 20
seconds: 0
conditions: []
actions:
- action: light.turn_off
target:
entity_id:
- light.hawaii_cocina_white_fan_2_bulbs
- light.hawaii_lightstrip
- light.hawaii_pineapple_light_l535e
- light.hawaii_white_fan_1_bulb_2_2
- light.hawaii_white_fan_1_bulb_2
mode: single
```
| Setting | Value |
|---------|-------|
| **Trigger** | No motion for 20 minutes |
| **Time Window** | Always active |
| **Lights Controlled** | 5 (same as above) |
---
#### 3. Hawaii Bedroom - Motion Lights On
**Purpose**: Turn on bedroom lights when motion is detected in the evening.
```yaml
id: '1767514792077'
alias: Hawaii Bedroom Camera Motion Turn On Lights
triggers:
- type: motion
device_id: 6977aea8e1b5d86fa5fdb01618568353
entity_id: 9e71062255147ddd4a698a593a343307
domain: binary_sensor
trigger: device
conditions:
- condition: time
after: '18:00:00'
before: '23:00:00'
weekday: [sun, mon, tue, wed, thu, fri, sat]
actions:
- action: light.turn_on
target:
entity_id:
- light.hawaii_bedroom_palm_lights
- light.hawaii_pink_rose_dimmer_plug
mode: single
```
| Setting | Value |
|---------|-------|
| **Trigger** | Bedroom camera motion sensor |
| **Time Window** | 6:00 PM - 11:00 PM |
| **Days** | Every day |
| **Lights Controlled** | 2 (palm lights, rose dimmer) |
---
### 📊 Automation Summary
```
┌─────────────────────────────────────────────────────────────────────┐
│ HAWAII AUTOMATION FLOW │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ LIVING ROOM BEDROOM │
│ ════════════ ═══════ │
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ Tapo Camera │ │ Tapo Camera │ │
│ │ Motion Sensor│ │ Motion Sensor│ │
│ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ Motion │ │ Motion │ │
│ │ Detected? │ │ Detected? │ │
│ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │
│ YES │ NO (20min) YES │ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ 4PM - 1AM? │ │ 6PM - 11PM? │ │
│ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 💡 Turn ON │ │ 💡 Turn OFF │ │ 💡 Turn ON │ │
│ │ • Fan bulbs │ │ All lights │ │ • Palm lights│ │
│ │ • Lightstrip │ │ │ │ • Rose dimmer│ │
│ │ • Pineapple │ │ │ │ │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘
```
### 🔌 Device Inventory (Hawaii)
#### Lights
| Entity ID | Device | Location |
|-----------|--------|----------|
| `light.hawaii_cocina_white_fan_2_bulbs` | Ceiling fan bulbs | Kitchen/Living |
| `light.hawaii_lightstrip` | LED strip | Living room |
| `light.hawaii_white_fan_1_bulb_2` | Ceiling fan bulb | Living room |
| `light.hawaii_white_fan_1_bulb_2_2` | Ceiling fan bulb | Living room |
| `light.hawaii_pineapple_light_l535e` | Pineapple lamp (Tapo L535E) | Living room |
| `light.hawaii_bedroom_palm_lights` | Palm tree lights | Bedroom |
| `light.hawaii_pink_rose_dimmer_plug` | Rose lamp (dimmer plug) | Bedroom |
#### Cameras (Tapo)
| Device | Location | Features |
|--------|----------|----------|
| Living Room Camera | Living room | Motion detection, PTZ |
| Bedroom Camera | Bedroom | Motion detection |
---
## 🏠 Concord Instance (Intel NUC) - Verified Feb 2025
### Hardware Details
- **Hostname**: vish-concord-nuc
- **Device**: Intel NUC6i3SYB
- **CPU**: Intel Core i3-6100U (2-core/4-thread, 2.3GHz)
- **RAM**: 16GB DDR4 (3.3GB used, 12GB available)
- **Storage**: 240GB Toshiba VX500 SSD (63GB used, 67%)
- **OS**: Ubuntu 24.04.3 LTS
- **Network**:
- **eth0**: 192.168.68.100/22
- **WiFi**: 192.168.68.98/22 (backup)
- **Tailscale**: 100.72.55.21 (exit node enabled)
- **Uptime**: 14+ days
### Deployment Method
- **Type**: Docker container
- **Image**: `ghcr.io/home-assistant/home-assistant:stable`
- **Config Path**: `/home/vish/docker/homeassistant/`
- **HA Version**: 2026.1.3
### Custom Components (HACS)
| Component | Purpose |
|-----------|---------|
| **HACS** | Home Assistant Community Store |
| **Frigate** | NVR / camera recording integration |
| **IPMI** | Server management (iDRAC, iLO, etc.) |
| **llama_conversation** | Local LLM conversation agent |
| **local_openai** | OpenAI-compatible local API |
| **Tapo** | TP-Link Tapo smart devices |
| **Tapo Control** | TP-Link Tapo camera PTZ control |
| **TP-Link Deco** | TP-REDACTED_APP_PASSWORD integration |
### Automations
📭 **None configured** - automations.yaml is empty
### Co-located Services (Same Host)
This NUC runs many additional Docker services alongside Home Assistant:
| Service | Purpose | Port |
|---------|---------|------|
| **Matter Server** | Matter/Thread protocol | 5580 |
| **AdGuard Home** | DNS ad-blocking | 53, 3000 |
| **WireGuard (wg-easy)** | VPN server | 51820 |
| **Plex** | Media streaming | 32400 |
| **Syncthing** | File synchronization | 8384 |
| **Invidious** | YouTube frontend | 3000 |
| **Materialious** | Invidious Material UI | 3001 |
| **YourSpotify** | Spotify listening stats | 4000 |
| **Watchtower** | Auto container updates | - |
| **Node Exporter** | Prometheus metrics | 9100 |
### Integration Opportunities
Since this instance has more powerful hardware and runs alongside media services, consider:
- **Frigate NVR**: Already has the integration, connect cameras
- **IPMI**: Monitor server hardware (if applicable)
- **Local LLM**: Use llama_conversation for voice assistant
---
## 🔧 Suggested Improvements
### For Honolulu Instance
1. **Add Bedroom "No Motion" Automation**
- Currently missing auto-off for bedroom lights
- Suggested: Turn off after 15-20 minutes of no motion
2. **Add Tailscale Add-on**
- Enable remote access without Cloudflare tunnel
- Can use as exit node for secure browsing
3. **Consider Adding**
- Presence detection (phone-based)
- Sunrise/sunset conditions instead of fixed times
- Brightness levels based on time of day
### For Concord Instance
- Document once SSH access is established
- Compare configurations between instances
---
## 📁 Related Documentation
- [Hardware Inventory](../infrastructure/hardware-inventory.md) - HA Green specs
- [Network Topology](../diagrams/network-topology.md) - Network layout
- [Tailscale Mesh](../diagrams/tailscale-mesh.md) - VPN connectivity