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

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. Enter credentials if required:
   • Amber Electric: API token
   • Localvolts: API key, Partner ID, and NMI
   • Flow Power portal and Octopus Saving Sessions: optional account/API 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. Enter battery connection details (see Battery System Setup)

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.