ESPHome LVGL Designer
LVGL Designer
GuideInstall ESPHomeHome Assistant Add-on
Chapter 1 · Install ESPHome 5 min

Home Assistant Add-on

Easiest path: install the ESPHome Add-on right from your Home Assistant Settings.

The Home Assistant Add-on is the easiest way to run ESPHome - it handles updates, file storage and OTA flashing for you. If you don't already run Home Assistant, jump to the CLI install or Docker install instead.

Fastest way - one click

If your Home Assistant instance is reachable from this browser, this button opens the ESPHome add-on page directly. Just click Install, then Start.

Open ESPHome Add-on in Home Assistant Opens in your HA instance →
After clicking, you'll land on the ESPHome add-on page. Hit Install (takes ~1 min), then toggle "Show in sidebar" and click Start. That's it.
ESPHome add-on page in Home Assistant showing the Install button

Manual install (if the button didn't work)

The button above requires My Home Assistant to be set up. If it didn't open anything, follow these steps instead.

1

Open Home Assistant Settings

In your Home Assistant interface, click the Settings icon at the bottom of the sidebar.

  • •Works on any HA install: HAOS, Supervised, or Container with the Supervisor.
2

Go to Add-ons

Pick "Add-ons" from the Settings menu - this opens the Add-on dashboard.

3

Open the Add-on Store

Click the blue "Add-on Store" button at the bottom right of the screen.

4

Search for ESPHome and install

Type "ESPHome" into the search bar, click the matching tile, then click Install.

Tip:Installation takes a minute or two - HA pulls the Add-on image in the background.
5

Start the Add-on and pin it to the sidebar

Toggle "Show in sidebar" and click Start. The first boot can take 30 seconds while the dashboard initialises.

ESPHome add-on page in Home Assistant after installing, showing the Show in sidebar toggle

You should see

A new ESPHome entry in your Home Assistant sidebar. Clicking it opens the ESPHome dashboard with an empty device list and a "+ New device" button at the bottom right.

That dashboard is where you'll do everything for the rest of this guide - create configs, paste YAML, flash devices over USB or OTA, and watch logs.

ESPHome add-on page in Home Assistant after installing, showing the empty state with a New Device button

Checkpoint - Is the ESPHome dashboard open in Home Assistant?

If yes - beautiful. The hardest setup step is already behind you.

Yes - keep going Add-on won't start / not visible
espboards.dev ESPboards.dev ·Made for the ESPHome community
TermsPrivacyRefund PolicyCookies

ESPHome LVGL Designer · also known as ESPHome Designer, ESPHome LVGL UI Designer, ESPHome LVGL Editor, LVGL Designer for ESPHome, ESPHome LVGL online editor, and ESPHome LVGL GUI builder. A free online ESP32 LVGL UI editor for the ESPHome community.