--- title: Adopt a Konnected device running ESPHome into ESPHome Dashboard description: Customize and secure your ESPHome based Konnected device. --- [Skip to content](https://support.konnected.io/adopt-an-esphome-device-into-esphome-dashboard#main-content) English Show submenu for translations [Submit a Ticket](https://support.konnected.io/kb-tickets/new?hsLang=en) [Customer portal](https://support.konnected.io/tickets-view?hsLang=en) ![Refreshed Logo Blue (HQ)](https://support.konnected.io/hs-fs/hubfs/Refreshed%20Logo%20Blue%20(HQ).png?width=250&height=45&name=Refreshed%20Logo%20Blue%20(HQ).png) - [Tickets](https://22554404.hs-sites.com/tickets-view) - [Sign out](https://22554404.hs-sites.com/_hcms/mem/logout) Open main navigation Close main navigation - [Tickets](https://22554404.hs-sites.com/tickets-view) - [Sign out](https://22554404.hs-sites.com/_hcms/mem/logout) - English Show submenu for translations - [Submit a Ticket](https://support.konnected.io/kb-tickets/new) - [Customer portal](https://support.konnected.io/tickets-view) - [Shop Now](https://konnected.io/collections/shop-now) [Shop Now](https://konnected.io/collections/shop-now) Konnected Knowledge Base - There are no suggestions because the search field is empty. 1. [Help & Support](https://support.konnected.io/?hsLang=en) 2. [ESPHome](https://support.konnected.io/esphome?hsLang=en) 3. [ESPHome](https://support.konnected.io/esphome?hsLang=en#esphome) # Adopt a Konnected device running ESPHome into ESPHome Dashboard ## Customize and secure your ESPHome based Konnected device. Konnected's pre-built ESPHome firmwares for our devices work *out-of-the-box* with Home Assistant using the most common basic configurations and settings. While some customization can be done in Home Assistant, for complete customization and security of your Konnected device running ESPHome, we recommend that you *adopt* your ESPHome devices into ESPHome dashboard, and use ESPHome's tools to *install* a customized firmware build specifically for your device. This article will guide you in setting up ESPHome Dashboard and adopting your Konnected device. ### ESPHome Dashboard ![Screenshot 2023-05-28 at 10.15.57 AM](https://support.konnected.io/hs-fs/hubfs/Screenshot%202023-05-28%20at%2010.15.57%20AM.png?width=688&height=422&name=Screenshot%202023-05-28%20at%2010.15.57%20AM.png)*ESPHome Dashboard is a web-based user interface to manage, update, and configure ESPHome devices on your network. There are **two common ways** to install/use ESPHome Dashboard:* #### Install ESPHome Dashboard as a Home Assistant Add-on ![Screenshot 2023-05-28 at 10.24.43 AM](https://support.konnected.io/hs-fs/hubfs/Screenshot%202023-05-28%20at%2010.24.43%20AM.png?width=277&height=435&name=Screenshot%202023-05-28%20at%2010.24.43%20AM.png)The simplest way to get started with ESPHome Dashboard is by installing the Add-on to Home Assistant. Most users who are [running Home Assistant Operating System](https://www.home-assistant.io/installation/) can use this method to install ESPHome Dashboard on their Home Assistant hardware, making an ESPHome dashboard tab available within Home Assistant. In Home Assistant, go to *Settings *\> *Add-ons* \> *+Add-on Store* and search for ESPHome. if you do not have the official ESPHome add-on repository added you can add with this button: [![supervisor\_addon](https://support.konnected.io/hubfs/Imported%20images/supervisor_addon.svg)](https://my.home-assistant.io/redirect/supervisor_addon/?addon=5c53de3b_esphome&repository_url=https%3A%2F%2Fgithub.com%2Fesphome%2Fhome-assistant-addon) After it's installed (it may take a while), enable the link in the Home Assistant sidebar by enabling the *Show in sidebar* setting. To launch the dashboard, click *Start* then *Open Web UI.* The downside of running ESPHome Dashboard on your Home Assistant hardware is that it can be slow to compile firmware updates, especially on a Raspberry Pi or similar hardware. Also, your ESPHome device configuration files will be stored on the Home Assistant device's filesystem, where it's up to you to make sure they're secure and backed up. #### Install ESPHome Dashboard on your computer ESPHome can also be installed on your computer, where you can run ESPHome dashboard locally as needed. Using this approach, all of your ESPHome firmware configuration files will be saved on your computer's hard drive. ***On a Mac:*** ESPHome can be installed on a Mac using [Homebrew](https://brew.sh/): ``` # Create a folder on your Mac to store your ESPHome configs> mkdir ~/esphome-configs> brew install esphome> cd ~/esphome-configs> esphome dashboard --open-ui . ``` The last line above starts the ESPHome dashboard web service on your computer and opens the UI in your default browser. ***On Windows:*** Follow these steps for [Installing ESPHome on Windows,](https://esphome.io/guides/installing_esphome.html#windows) then in the terminal, enter: ``` > esphome dashboard --open-ui . ``` ### Discover and Adopt the Konnected Device ![Screenshot 2023-05-28 at 10.53.04 AM](https://support.konnected.io/hs-fs/hubfs/Screenshot%202023-05-28%20at%2010.53.04%20AM.png?width=421&height=236&name=Screenshot%202023-05-28%20at%2010.53.04%20AM.png)Once ESPHome Dashboard is installed and running, and your Konnected Device running ESPHome is connected to your network, ESPHome Dashboard should automatically discover the device. Click *Adopt* to adopt the device and begin customization. You may be prompted to enter your Wi-Fi credentials. You will also be prompted to use an auto-generated API key for Home Assistant. We strongly recommend that you use the auto-generated key and copy it into Home Assistant to secure the communication between the device and Home Assistant. ![Screenshot 2023-05-28 at 11.04.25 AM](https://support.konnected.io/hs-fs/hubfs/Screenshot%202023-05-28%20at%2011.04.25%20AM.png?width=390&height=201&name=Screenshot%202023-05-28%20at%2011.04.25%20AM.png)Finally, your ESPHome configuration file will be created and you'll be prompted to *Install* the new configuration. Clicking *Install* will start the build and over-the-air update of a new firmware  compiled specifically for your device. Click *Skip* to skip the firmware build for now if you want to make more customizations first. The *Install* process may take a long time, especially on a Raspberry Pi or similar hardware.  ### Adding the API Key to Home Assistant After setting a unique API Key for your device to communicate with Home Assistant, you must copy the API key into Home Assistant to re-enable communication. ![Screenshot 2023-05-28 at 11.11.09 AM](https://support.konnected.io/hs-fs/hubfs/Screenshot%202023-05-28%20at%2011.11.09%20AM.png?width=295&height=149&name=Screenshot%202023-05-28%20at%2011.11.09%20AM.png)In Home Assistant, go to *Settings* \> *Devices & Services*. You should see a red tile prompting you to *Reconfigure *your ESPHome device. Click *Reconfigure* then paste the API Key created in the adoption step here. If you didn't copy the API key previously, go back to ESPHome Dashboard, click the three-dots menu next to the device then *Show API Key*.  - [Konnected Devices in General](https://support.konnected.io/konnected-devices-in-general?hsLang=en#main-content) - [Intro to Konnected](https://support.konnected.io/konnected-devices-in-general?hsLang=en#intro-to-konnected) - [Power](https://support.konnected.io/konnected-devices-in-general?hsLang=en#power) - [WiFi and Networking](https://support.konnected.io/konnected-devices-in-general?hsLang=en#wifi-and-networking) - [Firmware and Updates](https://support.konnected.io/konnected-devices-in-general?hsLang=en#firmware-and-updates) - [Security Best Practices](https://support.konnected.io/konnected-devices-in-general?hsLang=en#security-best-practices) - [Alarm Panel](https://support.konnected.io/alarm-panel?hsLang=en#main-content) - [Installation Guide Table of Contents](https://support.konnected.io/alarm-panel?hsLang=en#installation-guide-table-of-contents) - [Wiring and Connection Guides](https://support.konnected.io/alarm-panel?hsLang=en#wiring-and-connection-guides) - [Interfacing In-parallel with a Traditional Alarm System](https://support.konnected.io/alarm-panel?hsLang=en#interfacing-in-parallel-with-a-traditional-alarm-system) - [Alarm Panel Pro](https://support.konnected.io/alarm-panel?hsLang=en#alarm-panel-pro) - [6-Zone Alarm Panel & Alarm Panel Add-on (discontinued)](https://support.konnected.io/alarm-panel?hsLang=en#6-zone-alarm-panel-alarm-panel-add-on-discontinued) - [Standalone Alarm System](https://support.konnected.io/alarm-panel?hsLang=en#standalone-alarm-system) - [GDO blaQ](https://support.konnected.io/gdo-blaq?hsLang=en#main-content) - [Getting Started with the GDO blaQ](https://support.konnected.io/gdo-blaq?hsLang=en#getting-started-with-the-gdo-blaq) - [Platform Integrations](https://support.konnected.io/gdo-blaq?hsLang=en#platform-integrations) - [Device Features](https://support.konnected.io/gdo-blaq?hsLang=en#device-features) - [GDO White](https://support.konnected.io/gdo-white?hsLang=en#main-content) - [Garage Door Opener White Installation and Setup Guide](https://support.konnected.io/gdo-white?hsLang=en#garage-door-opener-white-installation-and-setup-guide) - [Detailed Wiring Guide](https://support.konnected.io/gdo-white?hsLang=en#detailed-wiring-guide) - [Garage Door Opener v1 Installation and Setup Guide](https://support.konnected.io/gdo-white?hsLang=en#garage-door-opener-v1-installation-and-setup-guide) - [Accessories](https://support.konnected.io/accessories?hsLang=en#main-content) - [Backup Batteries](https://support.konnected.io/accessories?hsLang=en#backup-batteries) - [Sensors](https://support.konnected.io/accessories?hsLang=en#sensors) - [SmartThings](https://support.konnected.io/smartthings?hsLang=en) - [Home Assistant](https://support.konnected.io/home-assistant?hsLang=en) - [Hubitat](https://support.konnected.io/hubitat?hsLang=en#main-content) - [GDO White](https://support.konnected.io/hubitat?hsLang=en#gdo-white) - [Legacy drivers](https://support.konnected.io/hubitat?hsLang=en#legacy-drivers) - [Alarm Panels](https://support.konnected.io/hubitat?hsLang=en#alarm-panels) - [Troubleshooting](https://support.konnected.io/hubitat?hsLang=en#troubleshooting) - [Control4](https://support.konnected.io/control4?hsLang=en) - [ESPHome](https://support.konnected.io/esphome?hsLang=en#main-content) - [ESPHome](https://support.konnected.io/esphome?hsLang=en#esphome) - [Konnected Device API](https://support.konnected.io/esphome?hsLang=en#konnected-device-api) - [openHAB](https://support.konnected.io/esphome?hsLang=en#openhab) - [Matter](https://support.konnected.io/matter?hsLang=en) - [Frequently Asked Questions (FAQ)](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#main-content) - [Garage Door Opener](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#garage-door-opener) - [General](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#general) - [Pre-Purchase Guides](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#pre-purchase-guides) - [Troubleshooting](https://support.konnected.io/troubleshooting?hsLang=en#main-content) - [Hardware issues](https://support.konnected.io/troubleshooting?hsLang=en#hardware-issues) - [Frequently Asked Questions (FAQs)](https://support.konnected.io/troubleshooting?hsLang=en#frequently-asked-questions-faqs) - [Device Discovery](https://support.konnected.io/troubleshooting?hsLang=en#device-discovery) - [Konnected Device Firmware & Software](https://support.konnected.io/troubleshooting?hsLang=en#konnected-device-firmware-software) - [Legacy: HASS Install](https://support.konnected.io/troubleshooting?hsLang=en#legacy-hass-install) - [Legacy: Wiring Info](https://support.konnected.io/troubleshooting?hsLang=en#legacy-wiring-info) - [Garage Door Opener](https://support.konnected.io/troubleshooting?hsLang=en#garage-door-opener) - [Orders, Shipping & Returns](https://support.konnected.io/orders-shipping-returns?hsLang=en#main-content) - [Refund and Return Policies](https://support.konnected.io/orders-shipping-returns?hsLang=en#refund-and-return-policies) - [Shipping Information and Policies](https://support.konnected.io/orders-shipping-returns?hsLang=en#shipping-information-and-policies) - [Safety Information](https://support.konnected.io/safety-information?hsLang=en#main-content) - [Standards & Certifications](https://support.konnected.io/safety-information?hsLang=en#standards-certifications) - [Warnings & Disclosures](https://support.konnected.io/safety-information?hsLang=en#warnings-disclosures) - [Products](https://support.konnected.io/products?hsLang=en#main-content) - [Depreciated Support Articles](https://support.konnected.io/products?hsLang=en#depreciated-support-articles) - [FAQs](https://support.konnected.io/faqs?hsLang=en#main-content) - [Additional Wiring Guides](https://support.konnected.io/faqs?hsLang=en#additional-wiring-guides) - [SmartThings Steps](https://support.konnected.io/smartthings-steps?hsLang=en) - [Noonlight](https://support.konnected.io/noonlight?hsLang=en) - [Alexa](https://support.konnected.io/alexa?hsLang=en) - [Google Home](https://support.konnected.io/google-home?hsLang=en) [![Konnected](https://support.konnected.io/hubfs/konnected-logo-white.svg "Konnected")](http://konnected.io) [mailto:help@konnected.io](mailto:help@konnected.io) Copyright © 2025, Konnected Inc.