HomeLabDocs/home-assistant-complete.md

4.5 KiB
Raw Blame History

🏠 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