Integrating Your Solar System With Home Assistant

If you want to integrate your solar system with Home Assistant in New Zealand, the short answer is this: pick an inverter and battery that expose a local API or Modbus TCP connection, install Home Assistant on a Raspberry Pi or mini-PC on your home network, and use community-built integrations (Sungrow, Fronius, SolarEdge, Enphase Envoy local, Goodwe via SEMS or Modbus, Huawei, and Tesla Powerwall all have working options) to pull live generation, consumption, and battery data into dashboards and automations. The whole setup typically costs $200 to $500 in hardware, takes a weekend to dial in, and pays for itself by letting you shift loads (hot water, EV charging, heat pumps) to your free solar window instead of buying expensive grid power at peak times.

This guide is written for the Kiwi homeowner who has either just had solar installed or is about to, and who wants to actually see and control what their system is doing rather than squinting at a vendor app once a month. We'll cover which inverters play nicely with local control, how to wire it all together without breaking your warranty, and the automations that genuinely save money on a New Zealand power bill.

What Home Assistant Integration Actually Means for NZ Solar Owners

Home Assistant (often shortened to "HA") is a free, open-source home automation platform that runs locally on your own hardware. Unlike the cloud-only apps that ship with most inverters, Home Assistant keeps your data on your network, works when your internet drops, and lets you connect everything: solar, battery, EV charger, hot water cylinder, heat pumps, and smart switches.

For a New Zealand solar owner, this matters for three practical reasons:

• Visibility: You see real-time generation, consumption, export, and battery state-of-charge in one dashboard, not three different vendor apps.
• Automation: You can automatically turn on the hot water cylinder, start the dishwasher, or boost EV charging when surplus solar is being exported (low-value) and pause those loads during evening peak (high-cost).
• Independence: You're not at the mercy of a vendor pulling cloud support in five years, which has happened more than once in this industry.

If you're new to the wider Hardware & Tech topic, our guide to NZ solar hardware and tech covers the kit landscape; this article goes one layer deeper for the optimisers among us.

Which Inverters and Batteries Have Decent Local APIs

This is the make-or-break question. If your inverter only talks to a cloud service in China or the US, your automations will be slow, fragile, and dependent on someone else's server staying online. Local control is non-negotiable for serious automation.

The Best-Supported Inverters in NZ

Based on community integrations actively maintained in the Home Assistant ecosystem and what's commonly installed by NZ installers, these are your strongest options:

• Sungrow (SH-RS, SG-RS hybrids): Excellent local Modbus TCP support via the WiNet-S dongle. The community mkaiser/Sungrow-SHx-Inverter-Modbus-Home-Assistant integration is mature and exposes nearly every register you'd want.
• Fronius (Primo, Symo, GEN24): Built-in Solar API over your LAN, no dongle needed. The official Home Assistant Fronius integration is rock solid.
• SolarEdge: Has a local Modbus TCP option you must specifically request the installer to enable. Once on, the integration works well.
• Enphase (IQ7, IQ8 with Envoy): The Envoy gateway exposes a local API. Note that Enphase tightened token-based authentication in firmware D7+, so use the enphase_envoy integration with a token, not the legacy method.
• Goodwe: Local UDP integration works for many models and is built into Home Assistant core. For ET-series hybrids the local protocol is solid.
• Huawei (SUN2000): Modbus TCP via the SDongleA-05 with the popular wlcrs/huawei_solar community integration.
• Tesla Powerwall: Local API on the Gateway works well with the official Powerwall integration. Tesla has tightened auth, so check current docs.
• Victron (Cerbo GX, Multiplus): Best-in-class for off-grid or hybrid via MQTT and Modbus. Beloved by tinkerers.

The Tougher Ones

Some popular NZ-installed brands are cloud-only or partially locked down: many GivEnergy, some Solis, older Growatt, and some Alpha ESS units. You can often pull data via cloud APIs, but it's slower (60-second polling at best) and dependent on the vendor's servers. If you're still at the quoting stage, this is the single most overlooked spec to ask about. If you're researching brands, our coverage of what "Tier-1" actually means is a useful complement, though for inverters and batteries, local API support matters more than tier rankings.

The Hardware You Need to Get Started

You don't need a server rack in the garage. A modest setup runs Home Assistant 24/7 on very little power.

• Home Assistant device: a Raspberry Pi 4 (4GB) or 5 with a quality SD card or, better, an NVMe SSD hat. Around $180 to $280 from PB Tech or similar. Alternatively, a Home Assistant Green ($200ish landed) or a second-hand Intel NUC ($150-$250) for more grunt.
• Ethernet cable: hardwire it to your router. WiFi for the HA box is asking for headaches.
• For Modbus inverters: usually the existing WiFi dongle (Sungrow WiNet-S, Huawei SDongle) on your LAN is enough. No extra hardware.
• Optional CT clamp: a Shelly EM or Shelly 3EM ($80-$150) is brilliant for sub-circuit monitoring (e.g., metering the hot water cylinder or EV charger separately).

Total spend: usually $200-$500 depending on choices. That's a one-off cost for what becomes the brain of your energy-aware home.

Step-by-Step: Getting Solar Data Into Home Assistant

Step 1: Install Home Assistant OS

Flash Home Assistant OS to your Pi or mini-PC using the Raspberry Pi Imager. Boot it, plug in ethernet, and browse to http://homeassistant.local:8123 from any device on your network. Create your admin account. That's the platform installed.

Step 2: Put Your Inverter on the LAN

Most NZ installers configure the inverter dongle to talk to the vendor cloud over your WiFi. You want it on your LAN with a static IP address (set this via your router's DHCP reservation). For Modbus-capable inverters, you'll also need to enable Modbus TCP in the inverter's local web interface; some require a parameter change your installer can do remotely if needed.

Step 3: Add the Integration

Install HACS (Home Assistant Community Store) if the integration you need is community-maintained. Then add the integration via Settings → Devices & Services → Add Integration. Point it at your inverter's static IP. Within seconds you should see dozens of entities appear: PV power, battery SoC, grid import, grid export, daily yield, and more.

Step 4: Set Up the Energy Dashboard

Home Assistant has a built-in Energy Dashboard that's purpose-built for solar households. Go to Settings → Dashboards → Energy and map your entities:

• Grid consumption sensor and grid return (export) sensor
• Solar production sensor
• Battery charge/discharge sensors
• Individual device consumption (EV, hot water) if you have sub-metering

Within 24 hours you'll have a beautiful Sankey-style diagram of where every electron went. Most users say this single feature is worth the entire setup.

Automations That Actually Save Money on a NZ Bill

This is where the magic happens. The point isn't a pretty dashboard; it's getting more value out of every kWh your panels make. The exact savings depend on your buy-back rate and tariff structure, which is why we keep the live data in our hardware pillar and tariff tooling rather than hardcoding figures here.

Automation 1: Hot Water Cylinder Solar Diversion

A typical NZ hot water cylinder draws 2-3 kW. If your panels are producing 4 kW on a sunny afternoon and you'd otherwise export at low buy-back rates, you're far better off heating water with that surplus. Trigger logic:

• Turn on HWC when solar export > 2 kW for 10 minutes AND battery SoC > 80%
• Turn off HWC when solar export < 500 W for 5 minutes

You'll need a Shelly Pro or Sonoff relay wired in by an electrician to control the cylinder element. Don't DIY mains wiring; that's a job for a registered sparky.

Automation 2: EV Charging on Surplus Only

If you have an EV and a smart charger (Wallbox, Zappi, Easee, Tesla Wall Connector, OCPP-compatible), you can charge dynamically from solar surplus. The Zappi has this built in, but Home Assistant can do it for any OCPP charger with the right add-ons. Charge speed ramps up and down to match available solar in real time.

For Tech-Savvy Optimisers on a dynamic tariff like Octopus or Ecotricity, the next-level trick is to override solar-only charging when wholesale rates drop below a threshold overnight. Combine both worlds: free solar by day, low-cost wholesale by night.

Automation 3: Peak Avoidance

If you're on a time-of-use plan, automate the battery to discharge during the evening peak window (typically 5pm to 9pm) and pre-charge from solar during the day. Most hybrid inverters can do this natively, but Home Assistant lets you respond to weather forecasts: if tomorrow is cloudy, charge the battery a bit from the grid in the low-cost overnight window so you're not caught short.

Automation 4: Heat Pump Pre-Cooling and Pre-Heating

Pre-heating the lounge to 21°C from 2pm to 4pm on a sunny winter afternoon (using free solar) is far more cost-effective than running the heat pump from 6pm to 10pm on grid power. A simple automation that watches solar generation, indoor temperature, and forecast outdoor temperature can shave a surprising amount off the winter bill.

What This Means for You

For the ROI Pragmatist

The Home Assistant setup is a one-off ~$300 investment that genuinely improves payback. By shifting hot water, dishwasher, EV charging, and pool pump loads into your solar window, you're displacing grid power you'd have bought at retail and converting low-value exports into high-value self-consumption. Use the Solar System Cost & ROI Calculator to model the difference between 30% and 70% self-consumption; it's usually a meaningful shift in your payback timeline.

For the Tech-Savvy Optimiser

You're the target reader. Combine Home Assistant with a dynamic tariff (Octopus Intelligent NZ, Ecotricity, or similar), an EV with a smart charger, and a hybrid inverter with battery, and you've got a setup that arbitrages wholesale price signals while maximising self-consumption. This is genuinely the leading edge of residential energy in Aotearoa.

For the Eco-Conscious Family

The automations aren't just about money. The Energy Dashboard makes it visible to the whole household when the home is running on sunshine versus grid. Kids love it. It changes behaviour: people run the washing machine at midday instead of after dinner, and the house becomes more genuinely self-powered. Combined with N-type panels (see our N-Type vs. P-Type comparison) and a quality LiFePO4 battery, you've got a setup that's both ethical and effective.

Common Pitfalls Installers Won't Mention

Most NZ solar installers do a fine job hanging panels and commissioning the inverter, but the smart-home integration layer is genuinely outside their scope. Here's what to watch for:

• Cloud-locked inverters: If you ask "does this support local API access?" and you get a blank stare, that's a red flag. Ask before you sign.
• Installer locking the inverter: Some installers password-protect the local web interface and don't share the credentials. You own the kit; you're entitled to the installer-level access for your own system.
• Modbus disabled by default: Sungrow and SolarEdge often ship with Modbus TCP turned off. Politely insist your installer enables it at commissioning.
• Firmware updates breaking integrations: This happens occasionally. The Home Assistant community usually patches within days, but be patient with community-maintained integrations.
• Warranty FUD: No reputable inverter manufacturer voids warranty for reading Modbus data. Some do void warranty for writing control commands; be aware of the difference. Reading is safe; controlling charge/discharge sometimes needs vendor approval.

For more on installer behaviour and how to push back, our review of DAS Solar and Tongwei N-Type panels is part of our broader work pulling back the curtain on what gets sold in NZ.

Frequently Asked Questions

Do I need an internet connection for Home Assistant to control my solar?

No. That's the entire point. Home Assistant runs locally, and once configured, all communication between HA and your inverter happens on your home network. If your internet drops, your automations keep running.

Will this void my inverter warranty?

Reading data via Modbus or local API is universally accepted and does not affect warranty. Writing commands (e.g., forcing the battery to charge or discharge at specific times) sometimes requires installer-mode access and may have warranty implications with a few manufacturers. Stick to read-only operations if you're unsure, or ask the manufacturer directly.

Can I retrofit Home Assistant to my existing solar system?

Yes, in most cases. If you have a Sungrow, Fronius, SolarEdge, Enphase, Goodwe, Huawei, Tesla, or Victron system, retrofitting is usually a software-only exercise. For cloud-only systems, you may need to add a CT-clamp energy monitor (like a Shelly EM) to get useful real-time data.

How much does the Home Assistant hardware cost?

Budget $200 to $500. A Raspberry Pi 4 or 5 with a quality SSD is around $250 to $350 from PB Tech. A pre-built Home Assistant Green is around $200 landed. A used Intel NUC can do the job for $150 to $250.

Is this hard to set up if I'm not a developer?

The basics, getting solar data on a dashboard, are achievable for any reasonably confident user in a Saturday afternoon. The deeper automations (EV-solar diversion, dynamic tariff arbitrage) take longer to dial in. The Home Assistant community is genuinely helpful, and there are excellent NZ-specific guides on the official forum.

What's the best inverter brand for Home Assistant integration in NZ?

Fronius and Sungrow are the two strongest picks based on local API maturity and NZ installer availability. Fronius for plug-and-play simplicity; Sungrow for value and excellent hybrid options. Both are widely installed by reputable NZ installers.

Can Home Assistant control my battery directly?

Yes, with most modern hybrids (Sungrow SH series, Goodwe ET, Huawei LUNA, Victron, Tesla Powerwall). You can force-charge from grid during low-cost windows, hold charge for evening peak, or even discharge to export during high-price periods if your retailer allows it. Sungrow and Huawei in particular have excellent community integrations for this.

Does Home Assistant work with Octopus Energy NZ dynamic tariffs?

Yes. There are community integrations that pull half-hourly wholesale prices and let you trigger automations based on price thresholds. Combine this with battery and EV control and you've got a genuinely sophisticated residential energy management system.

Will my installer set this up for me?

Almost certainly not. Solar installers are electricians, not home-automation specialists. You'll either DIY this yourself (very achievable) or hire a smart-home integrator separately. Some Auckland and Wellington integrators are starting to offer combined services; it's worth asking.

Where to Go From Here

Home Assistant integration is one of those upgrades that quietly transforms how you relate to your solar system. Instead of being a passive monthly bill-watcher, you become an active operator who genuinely understands where every kWh goes. The setup is modest, the learning curve is gentle if you take it a step at a time, and the long-term value is significant, especially as dynamic tariffs become more common in Aotearoa.

If you're still in the quoting stage, the most important thing you can do today is ask any installer you're talking to: "Does this inverter expose a local Modbus or API connection?" If they don't know or it doesn't, keep shopping. For everyone else, start with the Hardware & Tech pillar for the wider context, then drill into the panel-tech siblings on N-type vs. P-type cells and what Tier-1 actually means.