GlassHomeDash
Skip to content

Updated

View MarkdownOpen in ChatGPTOpen in Claude

Quickstart

End-to-end in under 5 minutes: install, connect, customize. Assumes you already have Home Assistant running.

Before you start

  • A reachable Home Assistant URL (e.g. http://homeassistant.local:8123).
  • A device to run GlassHome on. Same machine as HA is fine. CPU requirements: SSE4.2 / ARMv8 (details).
  • No HA yet? You can still try demo mode. Skip to step 2 and pick Demo mode on the welcome screen.
  1. 1

    Install

    Pick one. Both deploy the same app.

    HA OS or Supervised users. Add the GlassHome Addon repository and install from the Add-on Store. One-click, no Docker needed.

    Everyone else. Run the container:

    docker run -d \
  --name glasshome-dash \
  -p 3123:3123 \
  -v glasshome_data:/data \
  --restart unless-stopped \
  ghcr.io/glasshome/dash:latest
  2. 2

    Open Dash

    Go to http://<host>:3123 in your browser. The setup wizard loads.

    For addon installs, <host> is your Home Assistant machine’s IP address (e.g. http://192.168.1.100:3123).

    No HA yet? Click Demo mode on the welcome screen to explore with simulated data.

  3. 3

    Connect to Home Assistant

    Enter your HA URL (with http:// or https:// and the port). Dash sends you to the HA login page to authorize; it redirects back to Dash automatically.

    Stuck? See Connecting.

  4. 4

    Add your first widget

    1. Tap the pencil icon to enter edit mode.
    2. Tap Add Widget.
    3. Pick a widget type, then pick the entity to bind.
    4. Tap Done. Changes saved automatically.
  5. 5

    Make it yours

    • Settings > Theme. Pick a preset or customize. Themes guide.
    • Settings > Dashboards. Add more dashboards, each with its own layout.
    • Settings > Remote Access. Reach the dashboard from outside your home. How.

What next

Mental model first?

If terms like Hub, addon, scope, and widget are blurring together, the Concepts page is one screen.