.png?width=250&height=45&name=Refreshed%20Logo%20Blue%20(HQ).png){kind=small}
Migrating from Konnected's Legacy Home Assistant Integration to ESPHome
Konnected's original Home Assistant integration component is deprecated and will be removed soon. Here's how to migrate.
The Konnected Alarm Panel has integrated locally with Home Assistant since 2018, but boy have things changed since then! The original Konnected Home Assistant component is now officially deprecated and will ultimately be removed from Home Assistant.
We recommend that all Konnected Alarm Panel Home Assistant users migrate their devices to the newer ESPHome firmware and integration by following this guide.
You may see a deprecation notice in Home Assistant if you are still using this deprecated integration. This is your reminder to migrate to the ESPHome integration before the integration is removed.
What has Changed? What is Changing?
Since 2023, Konnected has adopted ESPHome as our firmware platform of choice for all Konnected devices, replacing the original (legacy) NodeMCU based firmware. Read more about Konnected's firmware history.
The original Konnected integration for Home Assistant only works with the legacy NodeMCU based firmware, which is no longer receiving feature updates. All new Konnected Alarm Panels now ship with ESPHome firmware, and in order to receive all the new features of the Konnected Alarm Panel now and in the future, you must update your panel to the new ESPHome firmware.
Konnected is now part of the Works with Home Assistant program! To ensure the best user experience for all Konnected and Home Assistant users, the legacy Konnected integration is being removed from Home Assistant by [sometime in 2026].
Migration Overview
There are a few steps involved to migrate, so grab a fresh cup of coffee, your computer or laptop, your Konnected Alarm Panel, and a micro-USB cable to physically re-flash your device.
Migrating your Konnected Alarm Panel to ESPHome will cause all of your Konnected device entity IDs to change in Home Assistant. If you have a lot of automations tied to Konnected binary_sensor or switch entities in Home Assistant, updating the Entity IDs may be a tedious process!
Here are the overall steps to migrate (detailed below):
- Take a screenshot or write down your Alarm Panel zone assignments, including the zone number, device class (door, window, motion, etc) and name of each zone. You will need to re-create these later.
- Flash your Konnected Alarm Panel device using a laptop or computer and USB cable at install.konnected.io with the latest Made for ESPHome release.
- Re-connect the Konnected Alarm Panel to WiFi or Ethernet.
- Discover the Konnected Alarm Panel using the Konnected App. Then tap Settings and accept the terms of Konnected's configuration service.
Advanced users can instead adopt the Konnected device into ESPHome Device Builder if you prefer to edit and manage the YAML configuration for ESPHome yourself. - Tap Zone Settings and set up all of the device zone assignments in the Konnected App.
- Make any other settings updates desired, then tap Save & Continue and then Build Now.
- Once the firmware build is complete, tap Update Now to push the firmware update to your device.
- In Home Assistant, go to Settings > Devices & Services > Integrations. The Konnected Alarm Panel should be automatically discovered. Click Add to add the device to Home Assistant.
- On the Integrations screen, find the (now disconnected) legacy Konnected integration, click on the integration heading, then click the 3-dots menu in the integration heading and click Delete.
- Now update any automations using Konnected sensors or switches to the new entity IDs.
Capture Current Zone Assignments
A simple way to capture the current zone assignments is to take screenshots of the legacy integration configuration screens. This should give you all the info you need to re-create your zone assignments again later. In Home Assistant, go to Settings > Devices & Services > Integrations and find the Konnected.io integration. Click on the integration heading, then click the 3-dots menu next to each integration entry and click Reconfigure.
Flash the Konnected Alarm Panel with ESPHome
You do not need to remove all of the wires from the Konnected Alarm Panel to re-flash it. If you have a laptop computer, the simplest way to re-flash it is to bring the laptop near the Konnected Alarm Panel, leaving everything hooked up and in-place, and plug in the USB cable to the Konnected device and your computer. The flashing itself only takes about two minutes.
Note: On the 6-zone Konnected Alarm Panels, Zone 6 needs to be disconnected or the zone needs to be open in order to re-flash. If Zone 6 is a door or window, you can simply leave that door or window open during the flashing process.
See: Flashing via Web Browser or Flashing via CLI