GbbConnect2 — Home Assistant Addon#
GbbConnect2 is available as a Home Assistant addon, allowing you to run it directly in HA without a separate Windows PC or Docker container.
The addon runs the GbbConnect2Console application and connects the inverter to GbbOptimizer via ModbusInMqtt.
Requirements#
- Home Assistant OS or Home Assistant Supervised (Supervisor required)
- An active GbbOptimizer account with a GbbConnect2 type installation
- A hybrid inverter with a datalogger (WiFi or Ethernet)
- A fixed IP address for the datalogger on the local network
Installation#
1. Add the repository#
Click the button below to automatically add the repository to Home Assistant:
Or manually:
- In Home Assistant, go to Settings -> Add-ons -> Add-on Store
- Click the menu (⋮) in the top right corner -> Repositories
- Add the repository URL:
1https://github.com/KrzysztofHajdamowicz/gbbconnect2-ha-addon - Click Add
2. Install the addon#
- In the Add-on Store, search for GbbConnect2
- Click Install
- Wait for the installation to complete
Configuration#
Before starting the addon, prepare the data from GbbOptimizer — see GbbConnect2 configuration (steps 2–5).
In the addon’s Configuration tab, fill in the fields:
| Field | Description |
|---|---|
plant_name | Installation name (as in GbbOptimizer) |
plant_driver_no | Driver type: 0 = SolarmanV5 (WiFi), 1 = ModBusTCP (Ethernet) |
plant_address_ip | Datalogger IP address on the local network |
plant_port_no | Datalogger port (usually 8899) |
plant_serial_number | Datalogger serial number (not the inverter!) |
gbboptimizer_plant_id | PlantId from GbbOptimizer |
gbboptimizer_plant_token | PlantToken from GbbOptimizer |
gbboptimizer_mqtt_address | MQTT server address — see MQTT Servers |
gbboptimizer_mqtt_port | MQTT port (usually 8883) |
server_autostart | Automatic server start (recommended: true) |
The datalogger must have a fixed IP address on the local network. Set a DHCP reservation on your router.
The serial number is the datalogger’s serial number, not the inverter’s. Common formats: 17xxxxxxx, 21xxxxxxx, 40xxxxxxx. You can find it using the Windows version of GbbConnect2 (Search for Inverters function).
Starting#
- Go to the addon’s Info tab
- Click Start
- Check the Log tab — wait for a connection established message
- In GbbOptimizer, verify that data from the inverter is being received
The addon should run 24/7 so that GbbOptimizer can collect data and send commands to the inverter.
Troubleshooting#
- Cannot connect to inverter — check the datalogger IP address, port, and serial number. Make sure HA can reach the datalogger on the network.
- Cannot connect to MQTT — verify the PlantId, PlantToken, and MQTT server address. Check that port 8883 is not blocked by a firewall.
- Authentication error — generate a new token in GbbOptimizer and update the addon configuration.
Enable is_verbose_log, is_driver_log, and is_driver_log2 in the configuration for detailed diagnostic logs.