Skip to main content

WiFi Provisioning Step by Step

1. Power on ESP32​

Connect power. Wait 10–15 seconds for setup mode to start (blinking LED if present).

2. Join the setup network​

  1. On phone or laptop: open WiFi Settings.
  2. Select: Homatic-Setup-XXXX (XXXX = last digits of MAC).
  3. Most builds do not require a password for the setup AP.

3. Open the setup portal​

  1. Open a browser.
  2. Go to: http://192.168.4.1
  3. If it does not load, try http://192.168.4.1/setup

4. Enter credentials​

FieldInstructions
WiFi SSID2.4 GHz network only (ESP32 does not support 5 GHz)
WiFi PasswordRouter password
MQTT HostBroker hostname or LAN IP (e.g. mqtt.homatic.io)
MQTT PortUsually 1883
Device NameLowercase only: sala, bedroom

5. Save and connect​

  1. Tap Save or Connect.
  2. ESP32 reboots and joins your WiFi.
  3. Disconnect from Homatic-Setup-XXXX and rejoin your normal network.

6. Verify in dashboard​

  1. Add a device with esp32_name matching Device Name.
  2. Try Toggle from device management at app.homatic.io.

Tips​

  • Place the ESP32 near the router during first setup.
  • If connection fails, clear provisioning (PROVISION_RESET in firmware) and repeat these steps.