HH Solar Manager
Documentation
Contents

Documentation

Everything you need to set up and get the most out of HH Solar Manager.

Getting Started

HH Solar Manager reads live telemetry from your Home Assistant instance and displays it in one beautiful dashboard. It takes about 5 minutes to set up if you already run Home Assistant.

Quick-start checklist
  1. Create your HH Solar Manager account
  2. Ensure Home Assistant is running and reachable over your local network (or externally)
  3. Generate a Long-Lived Access Token in Home Assistant
  4. Enter your Home Assistant URL and token on your Profile page
  5. Click Test Connection – you should see a green "Connected" badge
  6. Return to your Dashboard and enjoy real-time solar 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
  1. Open your Home Assistant instance and log in.
  2. Click on your user avatar in the bottom-left sidebar to open your profile.
  3. Scroll down to the Security section.
  4. Under Long-Lived Access Tokens, click Create Token.
  5. Give it a memorable name, e.g. HH Solar Manager.
  6. Copy the token that appears – you can only see it once!
  7. 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
FieldExample value
Display NameJane Doe
TimezoneEurope/London
Address Line 142 Sunshine Avenue
CityBrighton
Post CodeBN1 2AB
HA URLhttp://192.168.1.100:8123
HA TokeneyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9… (long string)

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

  1. Confirm Home Assistant is running and you can access it in a browser.
  2. Double-check the URL – include the port (usually :8123).
  3. Ensure your token has not expired or been revoked.
  4. 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.

  1. Go to HA → Developer Tools → States and search for battery, solar, or pv.
  2. Compare your entity names against the supported entity IDs table.
  3. 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.

Any inverter that exposes sensors in Home Assistant is supported. Common brands that work out of the box include SolaX, GivEnergy, Solis, SMA, Growatt, and Sungrow. Generic sensor names (e.g., sensor.solar_power) are also matched.

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.

Still stuck? We're happy to help.

Contact Support
An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.