How do I…?
A shortcut into the rest of the documentation, organised by what you are trying to do rather than by what part of the integration it belongs to.
Get started
| I want to… | Go to |
|---|---|
| Install Kilowahti | Installation |
| Set it up for the first time | First setup |
| Understand a term I keep seeing | Glossary |
| Know which entities actually matter | Entities → Start with these |
Run things when electricity is cheap
| I want to… | Go to |
|---|---|
| Switch something on during cheap hours | Triggers and conditions — no YAML needed |
| Change what counts as "cheap" | First setup → Tune the thresholds |
| Adjust that from a dashboard or automation | The price_threshold and rank_threshold number entities |
| Scale a device instead of switching it | Control factor |
| Schedule an appliance for the cheapest block ahead | kilowahti.cheapest_hours |
| Copy a working automation | Automation examples |
Make the prices match my bill
| I want to… | Go to |
|---|---|
| Add my grid operator's fees | Transfer pricing |
| Handle a day/night or seasonal tariff | Transfer pricing → Examples |
| Tell Kilowahti about my fixed-price contract | Fixed-price periods |
| Correct VAT, tax, or supplier margin | Configuration → VAT & electricity tax |
| Show prices in my local currency | Configuration → Display currency |
| Find out why my numbers differ from the bill | Troubleshooting |
Build a dashboard
| I want to… | Go to |
|---|---|
| Show current price and status | First setup → a minimal card |
| Draw a price curve for today and tomorrow | Enable price arrays in Configuration → Advanced options |
| See how well I shifted my consumption | Optimization scores |
Solar, battery, export
| I want to… | Go to |
|---|---|
| See what my exported electricity is worth | Enable generation, then export sensors |
| Find the best hours to sell | kilowahti.best_export_hours |
| Charge a battery on cheap electricity | Automation examples → battery |
| Plan around a solar forecast | kilowahti.generation_schedule |
Fix something
| I want to… | Go to |
|---|---|
| Work out why prices are missing or wrong | Troubleshooting |
| Understand why tomorrow is empty | Troubleshooting → Tomorrow's prices are missing |
| Find out why an entity does not exist | Troubleshooting → An entity is missing entirely |
| Report a bug or ask for a feature | GitHub or the feedback form |