Installation
All install methods deploy the same app. Pick by environment, not by feature set.
Pick a method
| Your setup | Use |
|---|---|
| Home Assistant OS or Supervised | HA Addon (recommended) |
| HA Container / Core | Docker Compose |
| Any other machine with Docker | Direct Container |
| Bare metal without Docker | Not supported. Run Docker or use HA OS. |
Requirements
- A running Home Assistant. Any install method, reachable on your network. Any recent Home Assistant release works.
- Docker (unless using the HA addon), or HAOS/Supervised with Supervisor for the addon.
- Modern browser to use Dash: Chrome, Firefox, Safari, or Edge.
Supported CPUs
GlassHome ships multi-arch images. Docker picks the right build automatically.
x86-64 (amd64)
Requires SSE4.2. Intel Nehalem (2008+) or AMD Bulldozer (2011+) and newer. Almost any PC from the last decade.
ARM64 (aarch64)
Raspberry Pi 4 and 5, Apple Silicon, most modern ARMv8 SBCs. Pi 3 and earlier are not supported.
Running in a VM? Read this.
Many hypervisors expose a Pentium 4-era CPU profile by default that hides SSE4.2 from the guest, even when the host CPU is modern. GlassHome will crash with signal 4 / illegal instruction. Switch the guest CPU to host (Proxmox), disable EVC (ESXi), or turn off processor compatibility mode (Hyper-V). Full fix: Troubleshooting → Illegal Instruction.
After installing
- Open
http://<host>:3123. - Run the setup wizard. See Connecting to Home Assistant.
- Add your first widget. See Quickstart.
Uninstalling
- Addon: Uninstall from the Add-on Store. Optionally check “remove data”.
- Docker:
docker rm -f glasshome && docker volume rm glasshome_data(this deletes your dashboards).