Connection methods on GbbOptimizer — Manual

Solarman

Mon, 01 Jan 0001 00:00:00 +0000

Solarman#

Solarman is a cloud-based method for connecting an inverter to GbbOptimizer. Data passes through Solarman servers — no additional software installation required.

Step-by-step configuration#

Add an installation: Add new installation with inverter connected to Solarman
Fill in the fields up to the “Solarman” group (details in Installation parameters)
Log in to the Solarman servers: enter your email and password (the same as for the Solarman app) and press Connect
Select your inverter from the list Select inverter SerialNo

DeyeCloud

Mon, 01 Jan 0001 00:00:00 +0000

DeyeCloud#

deye-only

DeyeCloud is a backup connection method available for Solarman-type installations. It can be used as a fallback in case of Solarman issues, or as the sole connection.

Operating modes#

Mode	Description
Disabled	DeyeCloud is not used
Enabled	DeyeCloud activates automatically when Solarman reports an error
Backup only	Do not use Solarman — always use DeyeCloud

Configuration#

In the Backup connection — DeyeCloud section of the installation parameters, select the operating mode
Enter the login credentials for DeyeCloud (may differ from Solarman)
Check Remember login credentials — without this, manual re-login is required
After connecting, select the inverter SerialNo

A detailed description of the parameters can be found in Installation parameters.

GbbConnect2

Mon, 01 Jan 0001 00:00:00 +0000

GbbConnect2#

GbbConnect2 is software running on the local network that connects the inverter directly to GbbOptimizer via ModbusInMqtt, bypassing cloud servers.

Requirements#

A computer with Windows or a Docker container running 24/7 on the local network
A Deye hybrid inverter with a WiFi logger (dongle)
A fixed IP address for the logger on the local network

Step-by-step configuration#

Download and install GbbConnect2: github.com/gbbsoft/GbbConnect2

DongleDirect

Mon, 01 Jan 0001 00:00:00 +0000

DongleDirect#

DongleDirect works similarly to GbbConnect2 — it connects the inverter to GbbOptimizer, but without installing additional software on the local network. The dongle (WiFi logger) is redirected directly to the GbbOptimizer server.

From 2026-03-09 changing Dongle settings may not be possible on some models. In that case, a Dongle reset and restoration of original settings is required.

Step-by-step configuration#

Note the GbbOptimizer server name from the browser address (e.g. gbboptimizer5.gbbsoft.pl)
Log in to the Dongle — you must know its IP address on the local network (login: admin, password: admin)
Go to the page http://<dongle_ip>/config_hide.html (manually change the address in the browser)
Take screenshots of all current settings (in case you need to restore them!)
Change the Server A Setting:
- Remove the IP address
- Note the original Server A domain name
- Change the domain to the GbbOptimizer server name (e.g. gbboptimizer10.gbbsoft.pl)
- Port: 10000
- Connection: TCP
- Save + Restart
Change the Optional Server Setting to the same data — Save + Restart
In GbbOptimizer, change the installation type to DongleDirect (or create a new one)
In the installation settings, enter:
- Inverter serial number
- Dongle serial number (digits only)
- Original Server A domain name — if this field is empty, GbbOptimizer will not copy data to Solarman and Solarman/DeyeCloud will stop working
Save and wait 2-5 minutes (the Dongle connects to the GbbOptimizer server after a few minutes)

The log should show entries such as:

1
2


2025-06-21 11:00:27: From Dongle: A501001047F585579AF6A5005E15
2025-06-21 11:00:28: From Server: A50A001017F685579AF6A50001AB745668780000008E15

Dongle reset#

If original Dongle settings need to be restored: