Documentation
Everything you need to get started
Step-by-step guides for connecting Home Assistant and building your first dashboard.
Quick Start
HA Integration
Drag & Drop Builder
DocsQuick Start
Introduction
Quick Start Guide
Get your CasaBoard dashboard up and running in under 10 minutes. Follow these three steps to go from zero to a working smart home dashboard — no account, no sign-up.
1
Run CasaBoard with Docker
Clone the repository, run docker compose up -d, and open the app on the port it exposes (default 3000).
2
Connect Home Assistant
On first run you're taken straight to the connection screen — enter your Home Assistant URL and authorise once.
3
Create your first page
Go to Pages and click 'New Page'. Give it a name like 'Living Room' and open the drag-and-drop editor to start building.
Free and self-hosted
There's no account, no subscription, and no data leaving your server. CasaBoard runs entirely on infrastructure you control.
What you'll need
- A running Home Assistant instance (local or remote)
- Your HA instance URL (e.g. https://ha.yourname.com)
- Docker and Docker Compose installed on the machine that will run CasaBoard