Skip to main content

How can I change Wi-Fi credentials on my device?

Reset the device to provisioning mode, then provision again from the phone app. You can use any of these methods:

  1. Physical button (BOOT button) – If you are using the standard RainMaker examples, press and hold the BOOT button for more than 3 seconds and release. The device enters provisioning mode (Wi-Fi credentials are cleared; RainMaker association is retained).

  2. System service (phone app) – If your firmware has System Service enabled with the Wi-Fi-Reset parameter, open the device in the ESP RainMaker phone app, go to Settings, and use the Wi-Fi Reset option. The device will clear Wi-Fi credentials and reboot into provisioning mode.

  3. RainMaker CLI – If the device is online and System Service is enabled, trigger Wi-Fi reset remotely:

    esp-rainmaker-cli setparams <node_id> --data '{"System":{"Wi-Fi-Reset":true}}'

    See RainMaker CLI User Guide and Parameter Management.

Optional (testing only): If the Serial Console is enabled, connect via UART (e.g., idf.py monitor) and run wifi-prov <ssid> [<passphrase>] to provision new Wi-Fi credentials directly. This is convenient for development but not suitable for end users.