On this page

Connect Home Assistant

Works with all plans, including the free Community plan.

Home Assistant is an open-source smart home platform for technically minded users, smart home enthusiasts, and developers. The energiedaten.at HACS integration imports Smart Meter data directly into Home Assistant Long-Term Statistics. No separate broker or additional middleware required.

Beta: The integration is in beta (version 0.5.x). Features and configuration details may still change.

Prerequisites

  • energiedaten.at account (Community plan or higher)
  • At least one connected meter with data
  • Home Assistant 2025.12.0 or later
  • HACS installed
  • API key with smart-meters:read and data:read permissions. Create one under Integrations → API Keys. Pick the longest lifetime your plan allows (Community: 1 year, higher plans: up to 3 years) to keep rotation infrequent.

Installation

The integration is now in the HACS default store and can be installed directly.

  1. Open HACS and search for "energiedaten.at"
  2. Open the entry and click Download
  3. Restart Home Assistant
  4. Go to Settings → Integrations → Add Integration → search for "energiedaten.at"
  5. Enter your API key. It is shown only once after creation in energiedaten.at, so paste it while it's still on your clipboard. The integration identifies your team from the key, so there is no separate team slug to enter.
  6. Select your meters (all connected meters are pre-selected); sensors are created per meter and energy direction

Key expiry: If the integration suddenly stops fetching data and the log shows 401 unauthenticated, your key has expired or been revoked. Create a new key and update it under Settings → Integrations → energiedaten.at → Configure.

Setting Up the Energy Dashboard

  1. Open Settings → Dashboards → Energy
  2. Add consumption sensors under Grid consumption
  3. Add feed-in sensors under Return to grid

Data appears with correct historical timestamps, not at the time of import. The Energy Dashboard will therefore show a complete consumption history from the first available reading.

Checking the Connection

Open Developer Tools → States and search for sensors with the prefix sensor. followed by the meter label. Each sensor shows the latest quarter-hour reading in kWh as its state.

EDA data is historical (T-1), not live. After initial setup, the first data can take up to 24 hours to appear, depending on the grid operator's EDA delivery schedule.

Notes

  • The integration polls incrementally for new data every 6 hours
  • A Refresh button triggers an immediate data fetch
  • The energiedaten.reimport service (Developer Tools → Services) re-fetches all historical data on demand
  • When the grid operator re-sends corrected readings, affected days are automatically re-fetched
  • For meters in an energy community, multiple sensors per meter may be created (different OBIS codes)
  • Source code and issues: github.com/energiedaten-at/ha-energiedaten