Overview

What metrd is, how it works, and what you can do with it.

metrd is a self-hosted energy monitoring service that runs on your local network. It polls your inverter, battery, and smart meter over their local APIs and stores the readings in a lightweight time-series database on your own hardware.

How it works

metrd runs as a background service — typically on a Raspberry Pi or small home server — and exposes a local dashboard and API. Nothing leaves your network unless you explicitly configure remote access.

The polling loop runs every few seconds depending on your hardware's supported rate. Readings are written to SQLite with a rolling retention window you control.

What you can monitor

• Solar PV generation (W and Wh)
• Grid import and export
• Battery charge, discharge, and state of charge
• House load
• Individual circuit clamps if your hardware supports them

What metrd is not

metrd does not control your hardware. It is read-only. It will not change charge schedules, tariff slots, or any inverter settings. For control, use your inverter's own app or API directly.