Documentation

Getting Started

HH Solar Manager reads live telemetry from your Home Assistant instance, Victron Energy systems, and UPS battery backups — all displayed in one beautiful dashboard.

Quick-start checklist

Create your HH Solar Manager account
If you use Home Assistant: generate a Long-Lived Access Token and enter it on your Profile page
If you have a Victron Energy system: go to Devices and add your Victron device (VRM Cloud or local CerboGX)
If you have a UPS with WinPower: go to Devices and add your UPS device
Return to your Dashboard and enjoy real-time energy data!

Home Assistant Setup

HH Solar Manager connects to Home Assistant via its REST API. Your Home Assistant instance must be accessible from the server running HH Solar Manager.

Supported Home Assistant versions

Any Home Assistant release from 2023.1 onward is supported. Core, OS, and Supervised install types all work equally well.

Network access

Scenario	URL format	Notes
Local network	`http://homeassistant.local:8123`	Works when HH Solar Manager runs on the same LAN
Local IP	`http://192.168.1.50:8123`	Use your HA server's fixed IP address
Nabu Casa / remote	`https://xxxxx.ui.nabu.casa`	Works over the internet with a Nabu Casa subscription
Custom domain	`https://ha.yourdomain.com`	Self-hosted reverse proxy setup

Creating a Long-Lived Access Token

A Long-Lived Access Token (LLAT) allows HH Solar Manager to securely read data from Home Assistant without your password.

Step-by-step instructions

Open your Home Assistant instance and log in.
Click on your user avatar in the bottom-left sidebar to open your profile.
Scroll down to the Security section.
Under Long-Lived Access Tokens, click Create Token.
Give it a memorable name, e.g. HH Solar Manager.
Copy the token that appears – you can only see it once!
Paste it into the Long-Lived Access Token field on your Profile page.

Keep your token safe. Anyone with this token can read your Home Assistant data. Store it securely and never share it publicly. You can revoke and regenerate a token at any time from your HA profile page.

Solar Entity IDs

HH Solar Manager automatically searches for common solar-related entity IDs in your Home Assistant. You do not need to configure entity IDs manually.

The following entity ID patterns are probed in order of priority. The first match wins:

Metric	Entity IDs searched (in order)	Unit
Battery State of Charge	`sensor.battery_soc` `sensor.battery_state_of_charge` `sensor.solax_battery_capacity` `sensor.givenergy_battery_percent`	%
Solar Input Power	`sensor.solar_power` `sensor.pv_power` `sensor.solax_pv_power_total` `sensor.givenergy_solar_power`	W
Home Load / Consumption	`sensor.load_power` `sensor.home_consumption` `sensor.house_load` `sensor.solax_load_power`	W
Total Solar Generated	`sensor.total_solar_generated` `sensor.energy_production_today` `sensor.solax_today_s_solar_energy`	kWh
Solar Forecast	`sensor.energy_production_today` `sensor.solcast_pv_forecast_forecast_today`	Wh / kWh

If your inverter brand uses different entity names, the best way to find them is to open Home Assistant → Developer Tools → States and filter by sensor. – look for entities with values in watts (W) or percent (%).

Profile Configuration

Visit your Profile page to configure the following:

Personal Information

Display Name: Your name shown in the app. Example: John Smith
Email: Your login email. Verify it to receive alerts.
Timezone: All timestamps are shown in your local time. Example: Europe/London

Home Assistant Connection

Home Assistant URL: The full URL to your HA instance.
Example: http://192.168.1.50:8123
Long-Lived Access Token: The token you generated in HA. Starts with a long string of letters and numbers.

Example profile values

Field	Example value
Display Name	Jane Doe
Timezone	Europe/London
Address Line 1	42 Sunshine Avenue
City	Brighton
Post Code	BN1 2AB
HA URL	`http://192.168.1.100:8123`
HA Token	`eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…` (long string)

Device Management

The Devices page is your central hub for managing all registered energy devices. You can register multiple devices of different types and view live data for each one.

Supported Device Types

Device Type	Icon	Description	Connection
Solar Inverter	☀️	Any solar inverter with Home Assistant integration	Home Assistant REST API
UPS + Smart Plug	🔋	UPS battery (CertaUPS, APC, Eaton) with WinPower JSON endpoint, controlled via Tapo/Kasa smart plug	WinPower JSON + Tapo bridge or cloud API
UPS (Monitor Only)	🖥️	UPS battery without smart plug control — monitoring only	WinPower JSON
Victron System	🛥️	Victron CerboGX / GX devices with MultiPlus, Quattro, SmartSolar MPPT	VRM Cloud API, local HTTP, or MQTT

Device Details Page

Each device has its own detail page at /device/{id}, accessible by clicking the 📊 button on the device card. This page shows:

Live Snapshot — real-time data from the latest poll (battery SoC, voltage, PV power, grid, etc.)
Refresh Now — fetch a fresh reading immediately from the API
Raw Data Table — the last 50 recorded data points in tabular format
Connection Details — device configuration and metadata

Use the Device Detail page to verify data is being received correctly from your devices.

Victron Energy Integration

HH Solar Manager supports connecting to Victron Energy systems via three methods. Full setup instructions are in the Victron Setup Guide (PDF).

Connection Methods

Method	Latency	Network	Best For
VRM Cloud Recommended	~1 min	Internet only	Users who don't want to expose their CerboGX
CerboGX HTTP	~1 min	LAN or VPN	Users who can reach their CerboGX on the network
CerboGX MQTT	Real-time	LAN	Future — needs MQTTnet package

Quick Setup (VRM Cloud)

Go to vrm.victronenergy.com → Settings → API Access
Click Create Token, give it a name, and copy it
Find your Installation ID — it's the number in your installation's URL: vrm.victronenergy.com/installation/123456/dashboard
Go to Devices → select Victron System (VRM Cloud)
Enter your token, installation ID, and device name
Click Test VRM Connection, then Add This Device

Data Collected

Battery SoC (%) — state of charge from the live feed (bs)
Battery Voltage (V) — from the live feed (bv)
Solar PV Power (W) — when available from Pdc
Grid Power (W) — import/export tracking
Load Power (W) — AC consumption
System State — Bulk, Absorption, Float, Inverting, etc.

Note: The VRM API Bearer token auth is deprecated from June 2026. The app automatically falls back to OAuth2 Client Credentials if Bearer auth fails.

UPS & Smart Plug Setup

HH Solar Manager can monitor a UPS battery via its WinPower JSON endpoint and optionally control a smart plug (Tapo P110/P115, Kasa KP115) to charge the battery when energy is cheap.

Requirements

A UPS with WinPower software that exposes a JSON status endpoint (typically https://ups-ip:8888/0/json)
(Optional) A Tapo P110/P115 or Kasa KP115 smart plug for automated charging control
(Optional) An HH-Bridge running on your home network for local smart plug control

How It Works

The app polls the WinPower JSON endpoint every minute for battery SoC
It checks the current Octopus Energy rate (if configured)
Based on your Logic Profile or device thresholds, it decides whether to turn the smart plug ON (charge) or OFF (save)
If the UPS is in bypass mode, the plug is never turned off (safety override)
All data is recorded as UpsDataPoints for historical tracking

Quick Setup

Ensure your WinPower JSON endpoint is accessible (port-forward or local network)
Go to Devices → select UPS + Smart Plug or UPS (Monitor Only)
Enter the WinPower JSON URL (e.g. https://192.168.1.50:8888/0/json)
If using a smart plug, configure the bridge URL and API key, or enter Tapo cloud credentials
Set your charging thresholds (min SoC% to turn ON, max SoC% to turn OFF)
Click Test WinPower, then Add This Device

Safety Features

Bypass detection: If the UPS is in bypass mode, the app will never turn the smart plug off
Min/max thresholds: Configurable battery levels to prevent over-discharge
Octopus rate awareness: Only charges when rates are low

Dashboard Overview

The dashboard shows your most recent solar snapshot. Cards refresh every time you load the page, and the Refresh Now button pulls a fresh reading on demand.

87%

Battery SoC

3,241 W

Solar Input

1,180 W

Home Load

18.4 kWh

Today's Generation

The example values above illustrate what you will see on a sunny day with a typical 5 kWp solar system and a 10 kWh battery.

History & Charts

The History page shows interactive charts of your solar data over time. Use the date pickers to select a custom range, or use the quick-select buttons (Today, 7 Days, 30 Days).

Battery SoC line – tracks how full your battery was at each recorded point.
Solar Input bars – shows watts generated from your panels.
Load bars – shows how much power your home consumed.
Octopus Rate line – overlays the electricity unit rate (Solar Plus/Pro plans only).

Data is collected at the interval set by your subscription plan (1 hour on Free, 30 min on Solar Plus, 10 min on Solar Pro).

Octopus Energy Integration

If you are on an Octopus Agile or Octopus Go tariff, HH Solar Manager can overlay live half-hourly electricity rates on your charts and use them to suggest smarter charging windows.

To enable Octopus data, make sure your Home Assistant has the Octopus Energy integration installed and your sensors are available. HH Solar Manager will discover them automatically.

Octopus integration features are available on Solar Plus and Solar Pro plans.

Subscription Plans

Feature	Free £0/mo	Solar Plus £4.99/mo	Solar Pro £9.99/mo — 14-day trial
Solar monitoring
Historical data charts
Poll interval	Every 1 hr	Every 30 min	Every 10 min
Octopus Energy integration
Priority support

Start your 14-day free Solar Pro trial

Troubleshooting

Confirm Home Assistant is running and you can access it in a browser.
Double-check the URL – include the port (usually :8123).
Ensure your token has not expired or been revoked.
If using HTTPS with a self-signed certificate, the connection will still work (HH Solar Manager accepts any certificate by design for local installs).

This usually means no data has been recorded yet, or the entities HH Solar Manager is searching for don't exist in your Home Assistant.

Go to HA → Developer Tools → States and search for battery, solar, or pv.
Compare your entity names against the supported entity IDs table.
Wait for the next poll cycle (up to 1 hour on Free plan), or click Refresh Now on the dashboard.

Poll frequency depends on your plan. On the Free plan data is collected once per hour. Upgrading to Solar Plus reduces this to every 30 minutes, and Solar Pro polls every 10 minutes.

You can always get a fresh reading immediately by clicking Refresh Now on the Dashboard.

FAQ

Only if HH Solar Manager is hosted externally (e.g., on a cloud server or our hosted service). If you are self-hosting HH Solar Manager on the same local network as Home Assistant, a local URL such as http://192.168.1.50:8123 is sufficient.

Your token is stored encrypted in the HH Solar Manager database. It is never displayed in plain text after you save it, and it is never logged or sent to third parties.

Inverters: Any inverter that exposes sensors in Home Assistant is supported. Common brands include SolaX, GivEnergy, Solis, SMA, Growatt, and Sungrow.

Victron: Full support for CerboGX, Venus GX, MultiPlus, Quattro, and SmartSolar MPPT via VRM Cloud or local HTTP APIs.

UPS: Any UPS with WinPower software (CertaUPS, APC, Eaton) is supported. Smart plugs: Tapo P110/P115, Kasa KP115.

Yes. Go to Billing, click Manage / Cancel and follow the steps in the Stripe Customer Portal. Your plan will revert to Free at the end of the current billing period.

After the trial period your subscription automatically renews at £9.99/month. You will be charged via the payment method you provided at sign-up. You can cancel before the trial ends to avoid any charge.