---
title: "Installation"
description: "Install GlassHome as a Home Assistant addon, Docker Compose service, or standalone container. CPU requirements and VM gotchas covered."
canonical: https://glasshome.app/docs/installation
section: "Installation"
updated: 2026-06-09
---
# 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](/docs/addon) (recommended)                     |
| HA Container / Core                 | [Docker Compose](/docs/docker#docker-compose)             |
| Any other machine with Docker       | [Direct Container](/docs/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](/docs/troubleshooting#illegal-instruction).

## After installing

1. Open `http://<host>:3123`.
2. Run the setup wizard. See [Connecting to Home Assistant](/docs/connecting).
3. Add your first widget. See [Quickstart](/docs/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).