Do not use this guide with the
newer [Smart Plug / Plug32].
The ESP32 platform requires additional steps not covered in this guide.
This guide is relevant for:
If you're setting up a device for the first time rather than swapping, see our dedicated guides instead:
Changing between Tasmota and ESPHome will reset the device to factory defaults. For power monitoring devices, you may need to recalibrate the device to ensure correct readings. Our [LocalBytes Tools / Tasmota Power Monitoring Calibration] tool can help with this.
Which should I pick?
Tasmota uses MQTT to communicate, which requires a broker to connect it to Home Assistant. ESPHome connects to Home Assistant directly, with no broker required. See [LocalBytes Blog / Starting a Modern Smart Home] for more on MQTT.
None of our devices are locked to the firmware they ship with. Any device can be flashed with either firmware and swapped back again at any point.
Tasmota to ESPHome
- Download
minimal.ota.bin.gzand[device].ota.bin.gzfor your device: - Navigate to your device.
- Via Home Assistant:
- Go to [HA Settings / Devices & Integrations]
- Find the device you wish to reflash
- Click "Visit".
- Via Home Assistant:
- Click "Firmware Update"
- Upload the
minimal.ota.bin.gzfile. The device will reboot and launch a captive portal. - After reconnecting the device, upload
[device].ota.bin.gzto complete the firmware change.
From here, set it up as you would any other ESPHome device. We recommend using the ESPHome Device Builder App and clicking "Take Control". This will guide you through recompiling and reuploading the latest version of ESPHome.
ESPHome to Tasmota
- Download [Tasmota OTA / Release / tasmota-lite.bin.gz].
- Navigate to your device.
- Via Home Assistant:
- Go to [HA Settings / Devices & Integrations]
- Find the device you wish to reflash
- Click "Visit".
- Via Home Assistant:
- Upload
tasmota-lite.bin.gzvia the web-server. The device will reboot and launch a captive portal.- If you cannot find the "Firmware Update" button, add
web_server:to your YAML configuration.
- If you cannot find the "Firmware Update" button, add
- After reconnecting the device, you should self-update to the latest full release.
- Click "Firmware Update".
- Set the OTA URL to:
http://ota.tasmota.com/tasmota/tasmota.bin.gz - The device will reboot a few times and come up on the latest full release.
- Navigate to Configuration, Configure Other, and apply the template found in the relevant documentation:
The device will reboot once more and come back configured as a LocalBytes device, ready to set up like any other Tasmota device.
