Installation

Get metrd running on your hardware in a few minutes.

metrd runs as a self-hosted service. You need a machine that stays on — a Raspberry Pi, a home server, or an old laptop all work fine.

Requirements

  • Docker and Docker Compose, or Node.js 20+
  • Network access to your inverter or smart meter
  • A static IP or hostname for your inverter (recommended)

Docker

The fastest way to get running:

git clone https://github.com/metrd/metrd
cd metrd
cp .env.example .env
docker compose up -d

Open http://localhost:3000(opens in new tab) in your browser.

From source

git clone https://github.com/metrd/metrd
cd metrd
npm install
npm run build
npm start

Verify it's running

curl http://localhost:3000/api/health
# → {"status":"ok","version":"1.0.0"}

If your hardware isn't configured yet you'll see zeroes on the dashboard — that's expected. Head to Hardware to connect your first device.