GlassHome GlassHome
Skip to content

Updated

View Markdown Open in ChatGPT Open in Claude

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.

Installation

  1. 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. 2

    Install the addon

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

  3. 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.