Configuration

The setup wizard runs when you first add the integration. All settings are also editable later via Settings → Devices & Services → Kilowahti → Configure.

Setup steps

1. Basic settings

Field	Description
Name	Used in entity names, e.g. Home → sensor.kilowahti_home_spot_price
Price region	Your electricity market area (see supported regions)
Price resolution	15 minutes (96 slots/day) or 1 hour (24 slots/day) — match your contract's metering interval
Display unit	c/kWh or €/kWh

2. VAT & electricity tax

Pre-filled from your region's defaults. Adjust if your contract differs.

Note

All prices you enter elsewhere (transfer tiers, fixed periods) are always gross (VAT included). Spot prices from the API are always VAT-exclusive — Kilowahti applies VAT automatically.

3. Transfer pricing

Set up your network operator's transfer price tiers. Tiers are time-based rules evaluated in priority order — the first match wins.

You can skip this step and configure transfer pricing later in Options. See Transfer pricing for details.

4. Thresholds & control

Field	Description
Control max price	Price at or below this turns on the price_acceptable binary sensor
Max price includes transfer	Whether the price threshold compares against total price (spot + transfer) or spot only
Control max rank	Rank at or below this turns on the rank_acceptable binary sensor
Forward average window	Hours ahead used for the next_hours_avg sensor
Control factor function	Shape of the 0–1 control factor curve: Linear or Sinusoidal
Control factor scaling	Exponent applied to amplify extremes (1–3)

5. Optimization scores

A permanent Total profile is created automatically. You can link your main energy meter to it later via Options → Score profiles → Edit: Total.

Additional profiles can be added (e.g. per-device or per-circuit meters).

6. Sensor display

Field	Description
Expose price arrays as attributes	Writes today_prices and tomorrow_prices arrays to the spot_price sensor attributes — useful for Apex Charts dashboards but increases DB size
High precision mode	Shows more decimal places on price sensors

Updating settings

All settings except the initial region and name are editable at any time via Configure without restarting Home Assistant.

Warning

Changing the display unit after sensors have recorded data will cause unit mismatches in history graphs. You may need to clear sensor history or update dashboard cards manually.