---
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/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/installation#supported-cpus).

## Installation

  1. Add GlassHome to your addon store.
   
       <a
         href="https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fglasshome%2Fhomeassistant-addon"
         target="_blank"
         rel="noopener noreferrer"
         class="inline-flex items-center gap-2 rounded-xl bg-primary px-4 py-2.5 font-medium text-sm text-white shadow-sm no-underline"
       >
         Add Repository
       </a>
   
       > **Button didn:** 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. Find GlassHome in the Add-on Store and click Install.
  3. 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/installation#supported-cpus).

## Related docs

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