Why another dashboard?
The stock Home Assistant dashboard, Mushroom and Bubble Card are great if you enjoy building cards in YAML. Hearth is for a screen the whole household uses, and it does a few things card stacks do not:
- Arrange by dragging. Tiles snap into any cell, gaps and all, from 1×1 to 4×3. Each screen width keeps its own layout. No YAML.
- Rests like a clock. After a few quiet minutes the wall tablet rests on an analog face, a luxury dial, or large digits, dims at night, and wakes on motion, a door, or the doorbell.
- Shows what changed. When someone switches a light or a fan, or opens a door, a window, the lock, or the garage from elsewhere, the tablet plays it full screen: a bulb on its cord, a pull-string lamp, a chandelier, a ceiling or standing fan, a padlock, a garage door rolling up.
- Doorbell takeover. A ring fills the screen with that doorbell's camera.
- Activity that reads like a sentence. "Garage door closed by Alex." Noisy devices fold into one line, and changes made while no screen was open are kept.
- Works on your phone too, with the same tiles.
Hearth sits on top of the Home Assistant you already run. It does not replace it, and your automations stay where they are.
Quick start
With Docker Compose, on any machine that stays on (a mini PC, a NAS, a Raspberry Pi 5):
git clone https://github.com/zaintechsavvy/hearth
cd hearth
cp .env.example .env
echo "BETTER_AUTH_SECRET=$(openssl rand -base64 32)" >> .env
docker compose up -d --build
Open http://<that machine>:3000, create an account, and either connect Home Assistant (a long-lived access token from your HA profile) or choose Open the demo home to look around first. Compose starts Hearth, a Postgres database and the go2rtc camera relay.
If you open Hearth from other devices by IP (for example http://192.168.1.10:3000), set that as BETTER_AUTH_URL or add it to TRUSTED_ORIGINS. Once everyone in your household has an account, set DISABLE_SIGNUP=true.
On the wall: open Hearth on the tablet, add it to the home screen, turn on Wall tablet in Settings, and set the tablet to never auto-lock.
cp .env.example .env.local
# put a long random value in BETTER_AUTH_SECRET: openssl rand -base64 32
npm install
npm run dev
Open http://localhost:3000. Without DATABASE_URL, Hearth keeps its data in an embedded Postgres (PGlite) under data/pglite.
Configuration
| Variable | What it does |
|---|
BETTER_AUTH_SECRET | Required. Signs sessions and encrypts stored tokens and camera passwords. |
BETTER_AUTH_URL | The address people open Hearth at. |
TRUSTED_ORIGINS | Other addresses Hearth is opened at, comma separated. |
DATABASE_URL | Optional Postgres (Neon, Supabase, your own). Empty means the bundled database. |
STREAM_RELAY_URL | The go2rtc relay for cameras. |
DISABLE_SIGNUP | true closes sign up. |
Privacy
- Self-hosted. Hearth talks to your Home Assistant and nothing else.
- No telemetry, no analytics, no account with us.
- Secrets are encrypted at rest. Home Assistant tokens and camera passwords are sealed with a key derived from
BETTER_AUTH_SECRET before they reach the database. Passwords are hashed with scrypt.
- HTTPS is needed for phones to install Hearth and get alerts; docs/https.md walks through it.
Features
The dashboard, built from tiles you choose and arrange yourself.
The thermostat glows warm from the top when you raise it and cool from the bottom when you lower it.
Customize any tile: its size, icon, colour, and what press and hold does.
Activity: everything that happened, from Hearth and Home Assistant alike, and who did it.
Automations you can pause or snooze, and Settings in four short groups.
On a phone.
docs/guide.md walks through every screen.
What each device can do
| Kind | Home Assistant | Matter | Tile |
|---|
| Lights, switches, fans | light, switch, input_boolean, fan | OnOff, LevelControl, FanControl | Icon, card, vertical slider, large |
| Thermostats | climate | Thermostat | Compact or large dial |
| Locks | lock | Door Lock | Lock and unlock, unlocking asks first |
| Garage doors, gates, blinds | cover | Window Covering | Open, close, stop, and a position slider for blinds; opening a garage, door, or gate asks first |
| Door, window, motion, leak, smoke | binary_sensor | Boolean State, Occupancy | Reading |
| Temperature, humidity, light, battery | sensor with a device class | Temperature, Humidity, Illuminance, Power Source | Reading; batteries start hidden |
| Doorbells and buttons | event | Switch events | Last ring, and a full-screen call on a new ring |
| Cameras | camera (streamed through Home Assistant) | Recognised, not streamed | Live view |
| Scenes and scripts | scene, script, button | | Run |
For safety, scenes and automations can lock doors and close garage doors and gates, but never unlock or open them; that stays a deliberate press and hold on its tile.
Where your data lives
Hearth stores accounts, sessions, connections, cameras, and layouts in Postgres.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
