# 🏠 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
