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
   • Any region: Other / Custom 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 and AEMO VPP: AEMO spike settings. For Tesla Powerwall sites, set the correct Globird/TOU tariff in the Tesla app before continuing; PowerSync reads that Tesla tariff when Home Assistant starts.
   • Other/Custom TOU and NZ TOU: static tariff / retailer details
3. Select your battery system:
   • Tesla Powerwall, FoxESS, Sigenergy, GoodWe, Sungrow SH-series, AlphaESS, Solax Hybrid, ESY Sunhome, SAJ H2/HS2, Fronius Reserva, Neovolt/Bytewatt, or SolarEdge Home Battery / curtailment
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, optimizer backup reserve, hardware backup reserve, optional maximum grid import site cap, grid-charge allowance, and optional optimizer switches such as Auto-apply optimizer reserve, Spread Export Across Window, Spread Import Across Window, Flow Power Disable Idle, and Profit Max target settings
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.

If you use Tesla Powerwall + Globird, change the tariff in the Tesla app first, then restart Home Assistant or reload the PowerSync integration before relying on the optimizer. PowerSync caches the Tesla tariff as the baseline for sensor.power_sync_tariff_schedule and for restoring normal tariff behaviour after force charge/discharge or AEMO spike events.

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.