Quick Start

Get started with Homatic in five steps.

1. Create an account

1. Open app.homatic.io.
2. Register a new company or sign in with your existing account.
3. Complete tenant setup (name and subdomain).

2. Add a room and device

1. From the sidebar: Rooms → Add room (for example: Living Room).
2. Devices → Add device:
   • Name: Living room light
   • Room: Living Room
   • Device type: Lighting
   • Relay number: 1
   • ESP32 Board Name: sala (must match the name in firmware)

3. Set up ESP32

1. Flash firmware using the Homatic Flash Tool.
2. Connect WiFi and configure MQTT.
3. Confirm DEVICE_NAME in the sketch equals sala.

4. Test control

1. Return to the dashboard → Devices.
2. Press Toggle next to the device.
3. You should hear the relay click and see status update to Online/Offline.

5. First scene (optional)

1. Scenes → create a scene such as Evening that turns on several devices.
2. Run the scene with one click.

Quick troubleshooting

Issue	Fix
Device does not respond	Check MQTT broker and esp32_name
ESP32 not on network	Repeat WiFi provisioning
401 Unauthorized	Sign out and sign in again

What’s next

• Hardware overview
• Managing devices