---
title: "Home Assistant Addon"
description: "Install GlassHome as a Home Assistant addon. One-click setup for HAOS and Supervised users."
canonical: https://glasshome.app/docs/dash/addon
section: "Installation"
updated: 2026-06-09
---
# Home Assistant Addon

The easiest way to run GlassHome if you're on Home Assistant OS or Home Assistant Supervised.

## Prerequisites

- Home Assistant OS or Home Assistant Supervised (both include the Add-on Store with Supervisor).
- A 64-bit device: Raspberry Pi 4 or 5, or an x86-64 machine with SSE4.2. See [Supported CPUs](/docs/dash/installation#supported-cpus).

## Installation

1. **Add the repository** Add GlassHome to your addon store.

   Add Repository

   > **Button didn't work? Add manually:** Open **Settings > Add-ons > Add-on Store**, click the **⋮ menu** (top-right) and choose **Repositories**. Paste this URL and click **Add**:
   >
   > ```
   > https://github.com/glasshome/homeassistant-addon
   > ```

2. **Install the addon** Find GlassHome in the Add-on Store and click Install.

3. **Start and access** Start the addon. Open `http://<ha-ip>:3123` in your browser.

> **No sidebar entry:** Dash does not appear as an item in the HA sidebar (ingress is not supported). Open it directly at `http://<ha-ip>:3123`, where `<ha-ip>` is the IP address of your Home Assistant machine.

## Updating

Check **Settings > Add-ons** for available updates. You'll see a notification when a new version is available.

## Edge Channel

I publish early builds here for testing before they ship in the stable release. The same repository includes an **Edge** version of GlassHome. Enable **Advanced Mode** in your HA profile to see it in the Add-on Store. Edge runs on port **3124**, so it can run side by side with the stable addon.

> **Edge is for testing:** Edge builds may have rough edges. Use the stable version for your daily driver.

## Troubleshooting

- **Addon not visible after adding the repository.** Refresh the Add-on Store page (the ⋮ menu has a "Check for updates" option). It can take a moment for the new addon to appear.
- **Addon fails to start: port conflict.** Port 3123 may already be in use on your HA host. Check for other services listening on that port and stop them before starting GlassHome.
- **Addon fails to start: unsupported architecture.** GlassHome requires a 64-bit CPU (Pi 4/5, x86-64 with SSE4.2). 32-bit installs and Pi 3 are not supported. See [Supported CPUs](/docs/dash/installation#supported-cpus).

## Related docs

- [Connecting to Home Assistant](/docs/dash/connecting): pair Dash with HA after install
- [Docker installation](/docs/dash/docker): alternative install for non-HAOS setups
- [Quickstart](/docs/dash/quickstart): first dashboard in five minutes
- [Troubleshooting](/docs/dash/troubleshooting): common install issues