# Runbook: Home Assistant

## Purpose

Operate the Home Assistant OS smart home automation platform.

## Current Service

- Product: Home Assistant OS 14.0
- Host: VM 105 `haos14.0` on proxtop (192.168.0.64)
- IP: `192.168.0.155` via DHCP
- URL via proxy: `https://ha.dropcutstud.io/`
- Direct fallback: `http://192.168.0.155:8123/`
- Resources: 2 vCPU, 8GB RAM (2GB balloon min), 32GB disk
- USB passthrough: Zigbee/Z-Wave dongles (host=1-2, 1-3, 1-7)

## Safety Notes

- HA controls home automation. Test config changes carefully.
- Use HA built-in backup system via Supervisor snapshots.
- Reverse proxy config on CT 105 handles TLS.
- Config file at `/mnt/data/supervisor/homeassistant/configuration.yaml`.

## Access

- Web UI: `https://ha.dropcutstud.io/` or `http://192.168.0.155:8123/`
- Admin: HA web UI after login
- Config edits: Via HA web UI (Settings → System → Configuration) or Proxmox QEMU agent

## Reverse Proxy

The Nginx reverse proxy (CT 105) serves `ha.dropcutstud.io` → `http://192.168.0.155:8123` with WebSocket support.

HA config already trusts proxy IP: `192.168.0.137`.

## Backups

- Backup class: `critical`
- Backup status: not configured
- Recommended: Use HA Supervisor snapshots (Settings → System → Backups)
- Automated backup add-on: Install "Google Drive Backup" or "Samba Backup" add-on
- VM-level: Proxmox snapshot of VM 105 possible but not ideal due to DB consistency

## Verification

```sh
curl -sS -o /dev/null -w '%{http_code}\n' http://192.168.0.155:8123/
curl -sk --resolve ha.dropcutstud.io:443:192.168.0.137 https://ha.dropcutstud.io/ -I
```

## Related Files / Systems

- Ansible inventory: `ansible/inventories/homelab/hosts.yml` (home-assistant)
- Reverse proxy runbook: `runbooks/nginx-reverse-proxy.md`
- Proxy config: `/etc/nginx/sites-available/ha.dropcutstud.io.conf` on CT 105
- Change log: `docs/server-change-log.md`