# 🏠 Home Assistant - Proxmox VM 100 (Complete)

Home Assistant is the core of the homelab automation stack. This instance runs as a full virtual machine using Home Assistant OS (HAOS), providing Supervisor support, secure remote access, and local integrations.

---

## 📌 VM Overview

| Field               | Value                                 |
|---------------------|----------------------------------------|
| **VM ID**           | 100                                   |
| **Hostname**        | homeassistant                         |
| **IP Address**      | 192.168.1.36                           |
| **MAC Address**     | BC:24:11:53:5B:9D                      |
| **Bridge Interface**| vmbr0                                  |
| **Memory**          | 8192 MB (8GB)                          |
| **CPU**             | 4 vCPUs (2 sockets × 2 cores)          |
| **Disk**            | 96GB (ZFS volume on `vm_data`)         |
| **On Boot**         | Enabled                                |
| **Cloudflare Tunnel**| Yes — `wtfsolutions.cc`              |
| **TLS Termination** | At Cloudflare Edge                     |

---

## 🧠 System Information

| Field               | Value                                  |
|---------------------|----------------------------------------|
| **OS**              | Home Assistant OS 16.0                 |
| **Architecture**    | amd64                                  |
| **Supervisor**      | Installed (2025.07.1)                  |
| **Core Version**    | 2025.7.1                               |
| **Docker**          | Used internally by HA OS               |
| **Default Port**    | 8123                                   |
| **Internal URL**    | http://192.168.1.36:8123               |
| **External URL**    | https://wtfsolutions.cc                |
| **Credentials**     | Bitwarden → `homelab/home_assistant`  |
| **Admin User**      | `cdarrigo`                             |

---

## 🧩 Integrations & Add-ons

- Zigbee2MQTT (Zigbee device integration)
- ESPHome (DIY microcontrollers)
- Tasmota (flashed IoT devices)
- File Editor
- Terminal & SSH
- HACS (Home Assistant Community Store)
- Cloudflare Tunnel (via external container)
- Add-on store enabled via Supervisor

---

## 🛠️ Configuration Files

| File Path                   | Purpose                          |
|-----------------------------|----------------------------------|
| `/config/configuration.yaml` | Core HA configuration           |
| `/config/secrets.yaml`       | Credentials and tokens          |
| `/config/automations.yaml`   | Custom automations (if split)   |
| `/config/home-assistant.log`| Main log file                    |
| `/config/.storage/`         | JSON-backed UI settings          |

---

## 🔐 Remote Access

- **Tunnel Name**: `homeassistant`
- **Tunnel ID**: `8a3cb4ad-4538-4709-bf3c-aa52db05bfc4`
- **Public URL**: `https://wtfsolutions.cc`
- **TLS**: Handled by Cloudflare
- **Cert Issuer**: Google Trust Services - CN=WE1
- **Cert Expiry**: Sep 20, 2025

---

## 🔁 Backup & Recovery

| Method              | Notes                                         |
|---------------------|-----------------------------------------------|
| **HA Snapshots**    | Create via Supervisor UI (full/partial)       |
| **VM Backups**      | Manually via vzdump or ZFS snapshot           |
| **Restore Strategy**| Restore HA snapshot or Proxmox VM snapshot    |
| **Cloud Backups**   | Optional via Nabu Casa or rclone              |

---

## 🔍 Monitoring & Logging

- **System Health**: Accessible from Web UI → Settings → System
- **HA Log File**: `/config/home-assistant.log`
- **Update Channel**: Stable
- **Telemetry**: Opt-in via UI

---

## 📦 Storage Configuration

| Mount/Volume        | Description                     |
|---------------------|---------------------------------|
| `vm_data` pool      | Backing ZFS for full VM disk    |
| `/dev/sdX` internal | Managed by HA OS                |
| External mounts     | Not applicable                  |

---

## 🔒 Credentials & Access

- **Login User**: `cdarrigo`
- **Stored In**: Bitwarden → `homelab/home_assistant`
- **SSH/Terminal**: Managed via add-on
- **2FA**: Optional via UI settings
- **Mobile App**: Configured to use external domain

---

## 📝 Notes

- USB passthrough is enabled via Proxmox for Zigbee/Z-Wave
- Tunnel traffic is encrypted via Cloudflare (origin does not use TLS)
- No local SSL certs configured; all TLS handled at the edge
- Proxmox VM config:
  - `onboot: 1`
  - `bios: ovmf`
  - `scsihw: virtio-scsi-single`
  - `usb0: host=5-1.2`