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. You can also enter your electricity contract's monthly fixed fee here — it will be spread across days and shown as a daily cost sensor.
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 via Configure. 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 |
Tip
Price and rank thresholds can also be adjusted dynamically without reopening Configure — use the number.kilowahti_{name}_price_threshold and number.kilowahti_{name}_rank_threshold entities from the dashboard or an automation.
| 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 Configure → 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.