---
title: "Documentation"
description: "GlassHome is a modern, local-first dashboard for Home Assistant. Install in minutes, customize without YAML."
canonical: https://glasshome.app/docs
section: "Getting started"
updated: 2026-06-09
---
# GlassHome Documentation

A modern dashboard for Home Assistant. Connects directly to your HA instance over WebSocket. No cloud relay, no telemetry, no YAML required.

## Start here

  ### [Quickstart](/docs/quickstart)

Install, connect, and add your first widget in 5 minutes.
  ### [Concepts](/docs/concepts)

Hub, dashboard, addon, widget. The mental model in one page.
  ### [Installation](/docs/installation)

Pick a deployment method: HA addon, Docker, or container.

## Choose your path

  ### [I want to use it](/docs/widgets)

Add widgets, arrange dashboards, pick themes.
  ### [I want to build for it](/docs/widget-development)

Build and publish custom widgets with the SDK and CLI.

## Common tasks

  ### [Connect to Home Assistant](/docs/connecting)

OAuth flow, demo mode, URL gotchas.
  ### [Edit a dashboard](/docs/editing)

Add, move, resize, remove. Desktop and touch gestures.
  ### [Access from anywhere](/docs/remote-access)

VPN works today; managed tunnel in progress.
  ### [Theme it](/docs/themes)

7 presets or custom palette, light and dark.
  ### [Pro](/docs/pro)

One-time purchase. Unlocks community widgets and the theme editor.
  ### [Something broke](/docs/troubleshooting)

Look up by error message or symptom.

## What GlassHome is not

- **Not a replacement for Home Assistant.** HA still runs your automations, integrations, and devices. GlassHome is the UI layer in front of it.
- **Not a cloud service.** Dash runs on your hardware. Your Hub account exists only to publish widgets and (optionally) provision a tunnel.
- **Not config-as-code.** Everything is configured in the UI. No YAML, no restart-to-apply.

> **Need help?:** Join the <a href="https://discord.gg/FJYdeDmrzv" target="_blank" rel="noopener noreferrer">Discord</a> for live support, or file a [bug report](/docs/bug-reports).