Leneda is a Home Assistant integration and dashboard for Leneda smart meters in Luxembourg. It combines electricity, solar production, gas, billing logic, reference-power analysis, and solar-value tracking in one interface, and it can also run outside Home Assistant as a standalone web app.
- Connects to the Leneda API and pulls electricity and gas data into Home Assistant.
- Groups configured meters into one coherent Leneda device experience instead of forcing you to assemble everything manually.
- Provides a custom dashboard with Dashboard, Sensors, Invoice, and Settings views.
- Supports Home Assistant mode, standalone local mode, and a hosted demo.
- Consumption, production, export, self-consumption, grid import, and gas tracking.
- Support for consumption meters, production meters, gas meters, and mixed setups.
- Aggregated totals across multiple production meters.
- Community-energy visibility for shared energy sent and received.
- Preset periods such as yesterday, this week, last week, this month, last month, this year, and last year.
- Custom date ranges for ad hoc analysis.
- Interactive dashboard with energy overview cards, energy-flow visualization, and range switching.
- Zoomable and pannable charts for detailed inspection of the selected period.
- Optional per-meter solar production charting when multiple production meters exist.
- Automatic recalculation of key metrics and invoice context when the visible chart range changes.
- Light and dark mode support.
- Responsive layouts for desktop and mobile.
- Home Assistant sensor entities for Leneda data.
- Consolidated Leneda device presentation in Home Assistant.
- Home Assistant panel for the custom dashboard.
- Home Assistant entity selection for sensor-based pricing inputs where applicable.
- Luxembourg-oriented invoice estimation covering supplier, network, taxes, VAT, discounts, and gas costs.
- Fixed-fee proration across the viewed period.
- Time-of-use supplier tariff windows.
- Reference power configuration and reference-power time windows.
- Exceedance charge calculation from 15-minute load intervals.
- Reference power level comparison to estimate which configured Creos level is financially optimal for the selected period.
- Print-friendly invoice layout for paper or PDF export.
- Solar production overview directly in the invoice.
- Self-consumption savings based on avoided grid purchases.
- Feed-in revenue based on exported energy.
- Per-production-meter feed-in pricing with fixed tariff or Home Assistant sensor mode.
- Reference-power savings when solar reduces net load enough to avoid exceedance charges.
- Combined total solar value so the worth of the panels is visible at a glance.
- Billing configuration directly in the dashboard.
- Reference power, exceedance rate, and reference-power windows.
- Supplier and network tariffs.
- Feed-in pricing per production meter.
- Per-meter monthly fees.
- Gas billing configuration.
- Currency, taxes, levies, and contract discount fields.
- Standalone credential entry and connection testing.
Dashboard: Main overview, flow view, charts, and top-level KPIs.Sensors: Table view of all fetched sensor values.Invoice: Electricity and gas invoice estimation, reference-power analysis, solar savings, and print view.Settings: Billing setup, feed-in pricing, reference power, meter fees, and standalone credentials.
| Dashboard | Energy Profile |
|---|---|
 |
 |
| Invoice Estimate | Cost Settings |
|---|---|
 |
 |
- Open
HACSin Home Assistant. - Go to
Integrations. - Click the menu in the top-right corner and choose
Custom repositories. - Add
https://github.com/koosoli/Leneda-integration. - Select category
Integration. - Install
Leneda. - Restart Home Assistant.
- Download the latest release from the Releases page.
- Copy
custom_components/lenedainto your Home Assistantconfig/custom_components/directory. - Restart Home Assistant.
Explore the dashboard with demo data at:
https://koosoli.github.io/Leneda-integration/
The hosted page stays on demo data until a Proxy URL is configured in Settings.
Once a Leneda-compatible proxy is available, the hosted page can use live data while keeping the entered credentials in the browser and forwarding them to the proxy for each request.
Run the dashboard outside Home Assistant:
cd frontend-src
npm install
npm run build
cd ../standalone
node server.jsThe standalone guide is available in standalone/README.md.
cd frontend-src
npm install
npm run dev -- --host localhost --port 5175 --strictPort --open- In Home Assistant, go to
Settings -> Devices & Services. - Click
Add Integration. - Search for
Leneda. - Enter your Leneda credentials and metering-point information.
- Optionally configure a reference-power source during integration setup.
- Open the Leneda dashboard panel and complete billing settings in the
Settingstab.
In standalone mode, the Settings tab is used for:
- Leneda API credentials
- Energy ID
- Metering point definitions
- Billing configuration
The app includes a connection test flow before saving credentials.
If you want the GitHub Pages build to use live data, run or deploy standalone/server.js and enter that server as the Proxy URL in the hosted dashboard settings.
| Capability | Home Assistant | Standalone |
|---|---|---|
| Leneda dashboard UI | Yes | Yes |
| Home Assistant sensors/entities | Yes | No |
| Sidebar panel | Yes | No |
| Home Assistant entity picker for sensor-based pricing | Yes | No |
| Direct Leneda API credential entry in dashboard | No | Yes |
| Billing configuration | Yes | Yes |
| Invoice and solar value analysis | Yes | Yes |
Release history is tracked in CHANGELOG.md.
If this project saves you time or helps you understand your energy usage better, support is appreciated:
- Buy me a coffee: buymeacoffee.com/koosoli
- GitHub Sponsors: github.com/sponsors/koosoli
Created and maintained by @koosoli.