---
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/dash/installation
section: "Installation"
updated: 2026-10-08
---
# 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/dash/addon) (recommended)             |
| HA Container / Core             | [Docker Compose](/docs/dash/docker#docker-compose)     |
| Any other machine with Docker   | [Direct Container](/docs/dash/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/dash/troubleshooting#illegal-instruction).

## After installing

1. Open `http://<host>:3123`.
2. Follow the welcome screen. See [Connecting to Home Assistant](/docs/dash/connecting).
3. Add your first widget. See [Quickstart](/docs/dash/quickstart).

## Uninstalling

- **Addon:** Uninstall from the Add-on Store. Optionally check "remove data".
- **Docker:** `docker rm -f glasshome-dash && docker volume rm glasshome_data` (this deletes your dashboards).