Installation

Installation

Prerequisites

• Home Assistant installed and running
• HACS (Home Assistant Community Store) installed
• A supported battery system with network access
• Electricity provider API credentials if required (see Electricity Providers)

Install via HACS

1. Open HACS in Home Assistant
2. Click the three dots in the top right
3. Select Custom repositories
4. Add repository URL: https://github.com/bolagnaise/PowerSync
5. Category: Integration
6. Click Add
7. Click Download on the PowerSync integration
8. Restart Home Assistant

Add the Integration

1. Go to Settings > Devices & Services
2. Click + Add Integration
3. Search for PowerSync
4. Click to add

Configure

The initial Home Assistant setup flow follows this order:

1. Select your electricity provider:
   • Australia: Amber Electric, Localvolts, Flow Power, Globird, AEMO VPP
   • UK: Octopus Energy
   • Europe: EPEX Day-Ahead
   • New Zealand: NZ TOU
2. Complete the provider-specific pricing step:
   • Amber Electric: API token, then site/NMI selection
   • Flow Power: NEM region and base rate, then network tariff
   • Localvolts: API key, Partner ID, and NMI
   • Octopus Energy: product and GSP region
   • EPEX: market region and VAT/tax settings
   • Globird, AEMO VPP, Other/Custom TOU, and NZ TOU: static tariff / AEMO / retailer details
3. Select your battery system:
   • Tesla Powerwall, FoxESS, Sigenergy, GoodWe, Sungrow SH-series, AlphaESS, Solax Hybrid, ESY Sunhome, SAJ H2/HS2, or Neovolt/Bytewatt
4. Select your optimization provider:
   • Smart Optimization (PowerSync LP), or the battery's native/built-in optimizer
5. If Smart Optimization is selected, enter optimizer basics:
   • battery capacity, maximum charge/discharge power, and optimizer backup reserve
6. Enter battery connection details (see Battery System Setup)

Initial setup ends after the battery connection step. Fine-tuning is done afterwards from Settings > Devices & Services > PowerSync > Configure or from the mobile app.

The Configure button opens a menu in this order:

1. Electricity provider options
2. Battery connection settings for your selected battery system
3. Optimization settings
4. AC inverter settings
5. Solar curtailment settings
6. Demand charge settings
7. EV charging settings
8. Weather and solar forecast settings
9. Auto-update settings

If you enter through Electricity provider options and continue through the full provider path, PowerSync then chains through demand charges, curtailment, optional AC inverter connection, weather/solar forecast, and EV charging.

Verify Setup

After setup, go to Settings > Devices & Services > PowerSync. You should see your battery and energy sensors listed under the integration. Key sensors to check:

• sensor.power_sync_solar_power
• sensor.power_sync_grid_power
• sensor.power_sync_battery_power
• sensor.power_sync_home_load
• sensor.power_sync_battery_level

If sensors are missing, check Settings > System > Logs for errors from custom_components.power_sync.