127 lines
4.5 KiB
Markdown
127 lines
4.5 KiB
Markdown
# 🏠 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` |