Skip to content
Setting Up ESPHome on Home Assistant OS

Setting Up ESPHome on Home Assistant OS

Introduction: In this guide, we’ll walk through how to set up ESPHome on Home Assistant OS, which is a great way to integrate DIY smart devices into your smart home. ESPHome allows you to create custom firmware for microcontrollers using YAML. When paired with Home Assistant, sensors and switches defined in ESPHome automatically appear in Home Assistant’s interface for seamless automations. 

Note: This guide assumes you are running Home Assistant OS or Home Assistant Supervised, which provides the Add-on Store

Installing the ESPHome Add-on in Home Assistant OS

To get started, we need to install the ESPHome add-on (sometimes called the ESPHome Device Builder) through Home Assistant’s add-on store. Follow these steps:

  1. Open the Add-on Store: In Home Assistant’s web interface, go to Settings > Add-ons

  2. Find ESPHome: In the add-on store, search for “ESPHome”. Click on the ESPHome or ESPHome Device Builder add-on from the results, then click the Install button. The add-on is fairly small, and installation should complete quickly. 

  3. Start the Add-on: Once installed, click Start to launch the ESPHome add-on. After a few seconds, you’ll see options to Open Web UI – click that to open the ESPHome interface in your browser.

After opening the ESPHome Web UI, you should see the ESPHome dashboard. If this is your first time, the dashboard will be empty, waiting for you to create a device.

Next Steps → Now that ESPHome is set up on your Home Assistant OS, you can proceed to flash an ESP device with ESPHome firmware. In the next article, we’ll guide you through flashing a real device (the Kincony KC868-A16 16-channel board) then setup ESPHome firmware to bring it online with Home Assistant.

Previous article Setting up the XIAO Smart IR Mate
Next article Basics of automations and scenes in home assistant

Leave a comment

Comments must be approved before appearing

* Required fields

See More

  • Choosing the right Home Assistant Server: HAS-B1, HAS-B2, or HAS-H3

    Choosing the right Home Assistant Server: HAS-B1, HAS-B2, or HAS-H3

    We stock a large range of Home Assistant servers that come pre-installed with Home Assistant OS. Each machine is hand-picked to provide reliable, local smart home control with silent, fanless operation. Below, we compare the specifications of each model so you can decide which one is the right choice to run your Home Assistant server on.

    Read now
  • Matter vs Reality: What Home Assistant Users Should Know

    Matter vs Reality: What Home Assistant Users Should Know

    You’ve probably heard of Matter — the new smart home standard backed by Apple, Google, Amazon, and others. It promises to fix compatibility headaches by letting all your devices talk to each other, regardless of brand or ecosystem.

    Sounds great. But if you’re already deep into smart home setups — especially with Home Assistant and Zigbee — you might be wondering: is Matter even relevant to me?

    Read now
  • Are Smart Home Products Effective at Saving Energy Over Winter?

    Are Smart Home Products Effective at Saving Energy Over Winter?

    Winter is when energy bills hit hardest — and it’s also when smart home technology proves its real value. While no single device is a magic fix, the latest research shows that well-designed smart heating systems consistently help households cut waste, improve comfort, and make heating far more efficient during the coldest months.

    Read now

Compare products

{"one"=>"Select 2 or 3 items to compare", "other"=>"{{ count }} of 3 items selected"}

Select first item to compare

Select second item to compare

Select third item to compare

Compare