---
title: "Home Assistant Documentation"
description: "## Documentation Index"
section: home-assistant
raw: "README.md"
source: ai-generated
tags: home-assistant, home-automation
last-updated: 2026-09-15
---

# Home Assistant Documentation

> Concepts and tips/tricks from this Home Assistant installation, written for a third party who may be setting up or improving their own instance. This is *not* an inventory of our rooms, devices, and automations — it's the reusable ideas behind them.

## Documentation Index

| # | Document | Concept |
|---|----------|---------|
| 1 | [Deployment](/home-assistant/01-deployment/) | Docker + git-managed config, Postgres over a unix socket, dynamic-subdomain reverse proxy |
| 2 | [High Availability](/home-assistant/02-high-availability/) | Active/standby two-instance cluster, webhook watchdog, the `input_boolean.active` gate |
| 3 | [Light brightness as state](/home-assistant/03-light-brightness-state/) | The 252/255 brightness trick — letting a light remember how it was turned on |
| 4 | [Automating with Google Home & HomeKit](/home-assistant/04-assistant-automations/) | State-trigger automations that work no matter which platform flipped the switch |
| 5 | [RFID tags & music albums](/home-assistant/05-rfid-music-albums/) | Tap an RFID tag to play an album |

## Templates

New documentation should follow the [doc template](/raw/_shared/templates/doc.md) at the
repo root.

## Conventions

- **Entity IDs** are written in `domain.name` format (e.g. `light.kitchen_lights`).
- **TODO** markers (`TODO:`) indicate items still to be filled in.
- Keep the language practical and opinionated: explain *why* a pattern exists,
  not just what it is.
- Prose is not hard-wrapped; tables use the compact `|a|b|` style (enforced by
  `.markdownlint.jsonc` at the repo root).

---

## Source Disclaimer

- [x] AI Generated
- [ ] Human Generated
- [x] AI Edited
- [ ] Human Edited