Docs

Quickstart

From a fresh install to a working HomeCmdr server with your first device in five minutes.

Configuration

Every option in config/default.toml — API binding, authentication, adapters, persistence, scenes, automations, and CORS.

Rooms and devices

How HomeCmdr models devices and rooms, and how to organise your setup using the HTTP API.

Scenes

Write Lua scenes to orchestrate devices with one API call or one dashboard button press.

Automations

Trigger Lua scripts automatically based on device state changes, schedules, solar events, and more.

Authentication

Master key setup, bearer tokens, API key creation and management, and role-based access control.

Dashboard

Running and extending the HomeCmdr reference dashboard — a zero-build-step Alpine.js web app.