GoodWe Inverter
goodwe
The GoodWe integration will poll a GoodWe solar inverter over the local network and present its runtime values as sensors in Home Assistant.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
sensor | Sensor (temperature) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
GoodWe inverters are read over the LAN; the Wi-Fi/LAN kit needs LAN set as the internet access port in SEMS. Occasional connection flapping reported after OS or kernel changes.
- Works2
- Partly works2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| GoodWe 4 MPPT inverter | Works | Support for 4 MPPT inverters added; operation mode select values localizedSaved copyBreaking change Inverter "Operation Mode" select values were changed to snake_case and localized. "General mode" -> "general" "Off grid mode" -> "off_grid" "Backup mode" -> "backup" "Eco mode" -> "ec Excerpt saved from GitHub on 2026-10-23. | PR #86901 · 2023-01 | |
| GoodWe inverters (port 502 FTP firmware) | Works Local | Support added for newer Wi-Fi+LAN 2.0 inverters using port 502Saved copyProposed change Goodwe Inverters have evolved and their wifi+lan 2.0 communication systems have also changed ports and protocols to connect with. This pull request is about updating the goodwe component in homeassistant core to support the new ports and protocols (UDP and TCP) available by the new communication system. With this change, you will be able to use the goodwe ezlink 3000 communication system and the wifi+lan 2.0 communication system with multiple inverters. For doing this, it is also mandatory to upgrade the goodwe library used by Excerpt saved from GitHub on 2026-10-23. | PR #147900 · 2025-07 | |
| GoodWe GW15K-ET | Partly works Local | Works on Wi-Fi module; LAN/Wi-Fi kit needs LAN selected as internet access port in SEMSSaved copyThe problem I have a GW15K-ET which works fine with HA GoodWe integration when using the Wifi module. But as soon as I change to the LAN/WIFI module then HA is not able to find it anymore. I remove everything and start new integration, I give it the LAN IP and it says "Unknown error occurred" Same if I give it Wifi IP from the LAN/Wifi module. But If I remove everything again, change to only Wifi module and give it the IP then it works great. LAN/Wifi module works as I can see data in SEMS portal. I found some info in the logs, please see below ### What version of Home Assistant Core has the … Excerpt saved from GitHub on 2026-10-23. | Issue #114173 · 2024-03 | |
| GoodWe GW5000-DNS-30 | Partly works Local | Worked on Wi-Fi module; unknown error after fitting LAN/Wi-Fi kitSaved copyI am having what seems to be the exact same issue with my inverter - GW5000-DNS-30. Worked fine with the wifi module while I waited for the LAN/Wifi module to arrive. Now that the LAN module is installed I am getting the same "Unknown error occurred" when re-adding the integration. Running on VM HassOS Excerpt saved from GitHub on 2026-10-23. | Issue #114173 · 2024-03 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 3,693 (0.52%) |
|---|---|
| Added in | Home Assistant 2022.2 |
| Set up in the UI | Yes |
| Maintainers | @mletenay, @starkillerOG |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
