homeassistant

1# Home Assistant
2
3Home Assistant Supervised installation on Debian 12+, plus Nginx Proxy Manager + CrowdSec and Semaphore UI.
4
5## Key Parameters
6
7| Variable | Default | Description |
8|----------|---------|-------------|
9| `ha_machine_type` | `qemux86-64` | Machine type for HA Supervised (e.g. `raspberrypi4-64`) |
10| `ha_os_agent_version` | `latest` | OS-Agent version to install |
11| `ha_data_share` | `/usr/share/hassio` | HA data directory |
12| `ha_network_manager_enabled` | `true` | Configure NetworkManager + systemd-resolved |
13| `ha_supervisor_enabled` | `true` | Install HA Supervised |
14| `ha_validation_enabled` | `true` | Run post-install validation checks |
15| `homeassistant_npm_enabled` | `true` | Nginx Proxy Manager (+ CrowdSec agent) |
16| `homeassistant_semaphore_enabled` | `true` | Semaphore UI on port `3000` (SQLite, LAN only) |
17| `vault_homeassistant.semaphore_*` | (vault) | `semaphore_admin_password`, `semaphore_admin_email`, `semaphore_access_key_encryption` |
18
19## Workflow
20
211. Validate Docker is installed and running
222. Install system dependencies (apparmor, dbus, jq, etc.)
233. Install Home Assistant Supervised `.deb` package
244. Install OS-Agent for hardware integration
255. Configure NetworkManager and systemd-resolved (if enabled)
266. Deploy Nginx Proxy Manager + CrowdSec (if enabled)
277. Deploy Semaphore UI (if enabled)
288. Validate installation (if enabled)
29
30Image updates: `ansible-playbook update-services.yml --limit homeassistant_servers` (tags: `npm`, `semaphore`).
31