website/docs/setup/ecodash.md

sidebar_position
1

🏠 HomeAssistant Setup

EcoDash requires HomeAssistant to run. Its purpose is translating the protocols that different smart plugs use into a simple universal HTTP API that EcoDash can use.

1. Install HomeAssistant: follow this guide. The installation method you choose doesn't matter.
2. Add your smart energy monitor. Go to Settings -> Devices and Services -> Add Integration -> Choose your device type. Follow this guide for Zigbee devices.
3. Generate an API Key for EcoDash:
   1. Go to your profile (bottom left of the page - click on your account name)
   2. Scroll to "Long-Lived Access Tokens"
   3. Press "Create token", give it a name and click OK
   4. Copy the token and paste it in a safe place.