Configuration¶
After installing Kite, the onboarding wizard walks you through granting permissions and entering your Dashboard URL. Everything can be adjusted later from the Settings screen (swipe open the control drawer → tap the settings icon).
Quick Reference¶
| Area | Where to configure | Guide |
|---|---|---|
| First launch & permissions | Onboarding wizard (runs automatically) | First-Time Setup |
| Dashboard URL & browser engine | Settings → Web kiosk | Web Kiosk |
| Home Assistant URL discovery | Settings → Web kiosk → Scan for HA | Home Assistant & MQTT |
| MQTT broker | Settings → MQTT | Home Assistant & MQTT |
| Motion / presence detection | Settings → Mode detector | Motion Detection |
| Theme, language, dock position | Settings → UI & UX | Appearance |
| Default launcher, restart | Settings → System | System Controls |
| Config export / import | Settings → Advanced | Backup & Restore |
Settings Screen Order¶
The Settings screen renders sections in this fixed order, which the User Guide mirrors:
- Mode detector — motion presence service
- MQTT — broker connection and telemetry
- Web kiosk — Dashboard URL, engine, whitelist, apps
- UI & UX — theme, dock position, language
- System — launcher, restart, version
- Advanced — export / import
Persistence
Toggle changes save immediately. Text field changes debounce by ~1 second before persisting — wait a moment after typing before navigating away.