Connect your solar inverter to RayHub

RayHub shows what your solar is doing by reading your inverter. Most inverters need one setting, Modbus, switched on first. This page shows you how, brand by brand. You don't need to be technical.

Your house and grid figures come from the meter your inverter uses. A hybrid or battery inverter has one as part of the install. A solar-only inverter needs its brand's smart meter fitted, and your brand's section below says which one.

Three things to know first

Each one takes a minute to understand. After that, the steps below are short.

  • Modbus is how your inverter shares its readings

    Modbus is a way for your inverter to share its numbers with other devices on your home network. It is often switched off when the inverter is installed. RayHub needs it switched on. It only reads. It doesn't change how your solar runs. To see where your inverter sits between your panels, house, grid and battery, see the solar power diagram.

  • The IP address is your inverter's number on your network

    Every device on your home network has an address made of four numbers with dots. It looks like 192.168.1.50. RayHub needs your inverter's address to find it. The section Finding the IP address shows where to look.

  • Both need to be on the same network

    RayHub joins your home WiFi. Your inverter must be connected to that same home network, by WiFi or by cable. If your inverter is on its own separate network, RayHub can't reach it.

Which brands work today

Sigenergy, SolaX Hybrid Gen4, Sungrow, Fronius Primo, GoodWe hybrid and Victron are verified in a real home. Several more brands are built and tested in our workshop.

Check your setup is supported before you buy. If you're not sure, email us at gday@rayhub.com.au with your inverter brand and model, and whether you have a battery. We'll tell you if RayHub supports it.

Verified in a real home

Verified means RayHub has run in a real home with that brand. Workshop tested means we have built support for that brand and tested it in our workshop. It has not run in a real home yet.

The steps for workshop tested brands have not been checked in a real home yet. If you have one of these brands, you can help us verify it by emailing us at gday@rayhub.com.au with your inverter brand.

Finding the IP address

Try these in order. Stop when you find it.

  1. Open your inverter's app on your phone.Look for a page called Network, Communication or WiFi. The IP address is often listed there.
  2. If it isn't there, open your internet router's app or settings page.Your router is the box your internet comes through. It keeps a list of connected devices. Look for a name with your inverter's brand in it.
  3. Write the address down. It looks like 192.168.1.50.
  4. Ask your router to keep that address for the inverter.Routers call this a reserved or fixed address. It stops the number changing later. If it changed, RayHub would lose the inverter. Your installer or internet provider can help with this step.

Telling RayHub where to look

You do this once, during setup on the screen or from your phone.

  1. When RayHub asks for your inverter's address, type the IP address.For example 192.168.1.50.
  2. Leave the brand on Automatic.RayHub works out which brand you have by itself.
  3. Only add a port number if your brand's steps below say so.A port is like a door number on the inverter. RayHub uses door 502 unless you say otherwise. To use another one, add a colon and the number, like 192.168.1.50:1502.

WiFi dongles

A few brands connect through a WiFi dongle instead of the inverter itself. Knowing this before your visit saves a second trip.

  • SolaX Hybrid Gen4 with the Pocket WiFi dongle

    On SolaX Hybrid Gen4 inverters, such as the X3-Hybrid G4, the Pocket WiFi dongle answers Modbus itself, on port 502, unit 1, not the inverter. It needs dongle firmware V3.004.03 or later. Older dongle firmware can't do this. That means the Pocket WiFi 3.0, the newer black dongle. The older USB style Pocket WiFi 2.0 doesn't share readings, and early Gen4 inverters with that socket can't take a 3.0. For those, an RS485 to network adapter on the inverter's COM port, set to Modbus TCP mode, is the route, the same adapter as Deye / Sunsynk and Fox ESS. Ask your installer. The dongle can go to sleep overnight and pick up a new address from your router, so ask your installer to set a DHCP reservation and give it a fixed address.

  • GoodWe with the stock Solar-WiFi stick

    GoodWe's stock Solar-WiFi stick uses Modbus RTU over UDP instead of the usual Modbus TCP, and answers on port 8899. The Modbus page has the address format and the rest of the GoodWe steps.

  • Deye / Sunsynk with a Solarman stick

    The Solarman stick that ships with many Deye and Sunsynk inverters also listens on port 8899, but over Solarman V5, which isn't Modbus. Point RayHub at the Modbus gateway instead of the stick. More on this is on the Modbus page.

  • Find my inverter needs the same home WiFi

    RayHub's Find my inverter sweeps your home network for the inverter and takes about a minute. A dongle that is asleep or sitting on a different WiFi network won't be found, so make sure it joins the same home WiFi as your solar display.

Keeping the address fixed

Your solar display finds your inverter by its address, so it helps if that address stays the same. The easiest way is to ask your router to keep it. Routers call this a reserved address or a DHCP reservation. Pick your inverter or its dongle in the router's list of devices and save its current address as reserved. If you would rather set the address on the inverter itself, choose one outside your router's automatic range so nothing else takes it. These brands let you do that.

  1. Fronius. Datamanager website, Settings, Network, then choose Static for the LAN address. On GEN24, Communication, Network, LAN.
  2. GoodWe. SolarGo app, Home, Settings, Communication Setting. On the Wi-Fi Kit or Wi-Fi Box you can also use the Solar-WiFi web page and set the DHCP mode to Static.
  3. SMA. SMA Connection Assist, Change network settings.
  4. Solis. SolisCloud app, Service, Local Debugging, Bluetooth, then LAN Port Settings and Static IP on the S2-WL-ST logger.
  5. SolarEdge. SetApp, Site Communication, Ethernet, Edit, Static IP.
  6. SolaX. SolaXCloud app, Dongle, settings icon, Network configuration, on the Pocket WiFi.
  7. Sungrow. iSolarCloud app, Network page, Ethernet connection, on the WiNet module.
  8. Victron. GX device, Settings, Connectivity, Ethernet.

What you see on the screen

Four views on your solar display, one tap apart. The gold ring shows where you tap. Figures are examples.

RayHub showing your energy flow 25.60 kWh of solar today. Solar is making 4.00 kW, your house is using 0.80 kW, your battery is 100 percent full and resting at 0.00 kW, and 3.20 kW is going to the grid. The status line reads Good time to use power. 25.57kWh today 25.58kWh today 25.59kWh today 25.60kWh today Tomorrow ~21 kWh SOLAR 4.00kW GRID 3.20kW Exporting BATTERY 0.00kW 100% HOUSE 0.80kW Good time to use power Settings
Your display shows where your power is going right now.
RayHub showing solar against the forecast Headed Solar vs forecast. A ring is most of the way round, with 25.6 kWh of solar today against a forecast of about 30 kWh. SOLAR VS FORECAST Tomorrow ~21 kWh 25.6 kWh of solar today Forecast ~30 kWh Good time to use power Settings
Tap the middle to see today's solar against today's forecast.
RayHub showing this week $8.29 spent this week and $10.02 earned. One bar a day for the last seven days, spent standing up in red and earned hanging down in green, today on the right. $8.29spent this week $10.02earned $2.00 $2.00 S S M T W T Today Good time to use power Settings
Tap again to see what you spent and earned this week.
RayHub showing this month $27.77 spent in October and $33.23 earned. One bar a day for the last 31 days, the days before the 1st of October fainter, today on the right. $27.77spent in October $33.23earned $5.00 $5.00 23 Sep 1 Oct Today Good time to use power Settings
Tap once more for this month, then tap to go back.

Sigenergy Verified

You can do this yourself in the mySigen app. The Sigenergy DC charger is verified in a real home too. Your display shows your car's charge level and how fast it is charging. There is more in our Sigenergy monitoring guide.

  1. Open the mySigen app.
  2. Tap System.
  3. Tap System Settings.
  4. Tap Modbus TCP Server Settings.
  5. Switch the Modbus TCP server on and save.
  6. Give RayHub the inverter's IP address. No port number is needed.

GoodWe Verified for hybrids

GoodWe hybrids are tested and verified in a real home. That home has a three phase GoodWe ETA hybrid. GoodWe MS string inverters are tested in our workshop. What you do depends on how your GoodWe connects to your network.

If your inverter has a network cable, or a LAN and WiFi kit

  1. Give RayHub the inverter's IP address. No port number is needed.
  2. If nothing shows up, Modbus TCP needs switching on.It is off when the inverter is new. On newer GoodWe inverters it is switched on in the SolarGo or SEMS+ app, under the inverter's communication settings. That usually needs the installer login, so ask your solar installer to switch it on.

If your inverter only has a small WiFi stick plugged into it

  1. Find the WiFi stick's IP address in your router's device list.
  2. Give RayHub that address with :8899 on the end.For example 192.168.1.80:8899. This is the door GoodWe's WiFi stick uses.

A GoodWe hybrid has its meter as part of the install. A GoodWe solar-only inverter, like the MS or DT, needs a GoodWe smart meter fitted for RayHub to read it.

There is more in our GoodWe monitoring guide.

Sungrow Verified for SH hybrids

This brand is tested and verified in a real home. That home has a Sungrow SH10RS hybrid that connects through its WiNet-S2 module. RayHub does not read Sungrow SG string inverters, like the SG5.0RS, yet.

If the Modbus switch is off, it lives on the WiNet module's own page

  1. Press the module's button three times.
  2. Join the SG hotspot it puts up.
  3. Open 11.11.11.1 in your browser and log in.
  4. Open Forwarding configuration.
  5. Switch Modbus port 502 on, with SSL off.

On the home we verified, the Modbus switch was already on. The iSolarCloud app can also reach it under the communication module's settings.

If your inverter has its own network cable socket, use that connection. The older WiNet-S stick is reported to allow one connection at a time. The WiNet-S2 ran two displays at once in our testing.

If a Sungrow iHomeManager is fitted, Find my inverter lists two devices. Pick the one labelled Sungrow. The other one is the iHomeManager and shows only an address.

There is more in our Sungrow monitoring guide.

Fronius Verified for Primo

This brand is tested and verified in two real homes. One has a Fronius Primo with a Datamanager 2.0 card and a Fronius Smart Meter. The other has a Fronius Primo 5.0 with a Datamanager 2.0 card and no Smart Meter, and shows solar only. The Primo GEN24 and Symo GEN24 are tested in our workshop.

Your Primo needs its Datamanager 2.0 card to connect. Most Primo inverters have it built in, and the Modbus setting is on its web page.

Check this before you change anything

Both sets of steps change the SunSpec Model Type, which changes how your inverter lays out its readings. Anything else that already reads your inverter would then read the wrong numbers. That could be Home Assistant, a battery system, a car charger or another monitor. If something else reads your inverter, ask your installer before you go ahead.

For a Primo GEN24 or Symo GEN24

  1. Open the inverter's web page in a browser.Type the inverter's IP address into the address bar. Your installer may need to log in for you.
  2. Go to Communication.
  3. Go to Modbus.
  4. Switch on the Modbus TCP server.
  5. Set SunSpec Model Type to int + SF.The factory setting is float. RayHub can't read float. If it is left on float, your display tells you to change it.
  6. Leave the meter address at 200.
  7. Leave Allow control switched off.RayHub only reads. It doesn't need control.
  8. Save.
  9. Give RayHub the inverter's IP address. If the Modbus page shows a port other than 502, add it on the end.

For a Primo or Symo with a Datamanager 2.0 card

  1. Open the Datamanager's web page in a browser.Type the inverter's IP address into the address bar. Your installer may need to log in for you.
  2. Go to Settings, then Modbus.
  3. Set Data export via Modbus to tcp.
  4. Set the Modbus port to 502.
  5. Set SunSpec Model Type to int + SF.The factory setting is float. RayHub can't read float. If it is left on float, your display tells you to change it.
  6. Leave String control address offset as it is.
  7. Leave Demo mode switched off.
  8. Save.
  9. Give RayHub the inverter's IP address.Your Fronius Smart Meter needs no setting. RayHub finds it.

A Fronius Smart Meter gives RayHub your grid and house figures. Without one, your display shows your solar only.

These settings don't change Solar.web. It keeps working as before.

There is more in our Fronius monitoring guide.

SolarEdge Workshop tested

This brand is tested in our workshop. It has not run in a real home yet. Our testing covers SolarEdge systems without a SolarEdge battery.

We don't have confirmed menu steps for SolarEdge yet.

The setting is usually called Modbus TCP. It is set in SolarEdge's SetApp, which normally needs your installer. Ask them to switch it on.

SolarEdge often uses door 1502. If so, give RayHub the address with :1502 on the end.

Your SolarEdge needs a SolarEdge meter at your grid connection. RayHub reads your grid and house figures from it.

A SolarEdge inverter allows one Modbus connection at a time. If another system already uses it, RayHub can't connect.

There is more in our SolarEdge monitoring guide.

Victron Verified for Cerbo GX, off grid

This brand is tested and verified in a real home. That home runs off grid with a Cerbo GX, two MultiPlus-II inverters and a solar charger. RayHub reads your Victron through its GX device, such as a Cerbo GX.

  1. Open the GX device's menu.Use its screen, or Remote Console in VRM.
  2. Go to Settings.
  3. Go to Services.
  4. Switch Modbus TCP on.It is off when the GX device is new.
  5. Give RayHub the GX device's IP address. No port number is needed.

There is more in our Victron monitoring guide.

AlphaESS Workshop tested

This brand is tested in our workshop. It has not run in a real home yet. These steps are for AlphaESS SMILE systems.

We don't have confirmed menu steps for AlphaESS yet.

The setting is usually called Modbus TCP. You may find it in the AlphaESS app under Settings, then Communication. If it isn't there, ask your solar installer to switch it on.

Give RayHub the inverter's IP address. No port number is needed.

An AlphaESS system allows one Modbus connection at a time. If another system already uses it, RayHub can't connect.

Some older AlphaESS systems have no network connection for Modbus. They need an extra adapter, so ask your installer.

Neovolt and ByteWatt systems are related to AlphaESS but work differently inside. These steps don't cover them yet.

There is more in our AlphaESS monitoring guide.

Deye / Sunsynk Workshop tested

This brand is tested in our workshop. It has not run in a real home yet. Deye and Sunsynk are the same inverter family under two names. The single phase and three phase hybrid models are both covered by these steps. Not sure which you have? See how to tell single phase from three phase.

These inverters share their data through a wired RS485 port, so they need a small gateway box to join your home network. Many solar installers already fit one for monitoring tools.

Ask your installer for an RS485 to WiFi gateway, such as the Elfin EW11. When the gateway runs in Modbus TCP mode, give RayHub the gateway's IP address. When it runs as a plain UDP link, add :8899 on the end.

The small WiFi stick that comes with many of these inverters is for the Solarman cloud app. RayHub can't read through it. Give RayHub the gateway's address, not the stick's.

If nothing answers, ask your installer to check that the inverter's Modbus address is set to 1.

There is more in our Deye and Sunsynk monitoring guide.

Fox ESS Workshop tested

This brand is tested in our workshop. It has not run in a real home yet. These steps are for current Fox ESS hybrids, the KH, H3 Pro, H3 Smart and EVO.

Fox ESS switched off readings through the inverter's network port in newer firmware. These inverters share their data through a wired RS485 port instead, so they need a small adapter fitted near the inverter to join your home network.

Ask your installer for an RS485 to WiFi adapter, such as the Elfin EW11, set to Modbus TCP mode. Give RayHub the adapter's IP address. No port number is needed.

The WiFi stick that sends your data to the Fox ESS app is a separate part. RayHub reads through the adapter, so give RayHub the adapter's address and not the stick's.

If nothing answers, ask your installer to check that the inverter's RS485 device ID is set to 247.

Older Fox ESS models such as the H1 work differently inside. These steps don't cover them yet.

If you have a Fox ESS system and would like to help us test, email us at gday@rayhub.com.au.

There is more in our Fox ESS monitoring guide.

SolaX Verified

SolaX Hybrid Gen4, through the Pocket WiFi dongle, is tested and verified in a real home. Your Gen4 connects through its Pocket WiFi 3.0 dongle. Gen2 and Gen3 are tested in our workshop. These steps are for SolaX X1 and X3 Hybrid inverters from Gen2 and Gen3, which have a network port built in, and for Gen4 through its Pocket WiFi dongle.

We don't have confirmed menu steps for SolaX yet.

Connect the inverter's own network port to your home network with a cable. Give RayHub the inverter's IP address. No port number is needed.

The Pocket WiFi dongle that sends your data to the SolaX app is a separate part. Recent firmware updates for some of these dongles turn off the local readings RayHub uses, so give RayHub the inverter's address and not the dongle's.

SolaX Hybrid Gen4 inverters have no network port of their own. That includes the Qcells Q.VOLT, which is a Gen4 SolaX under another name. They connect through the Pocket WiFi dongle instead, which needs dongle firmware V3.004.03 or later. SolaX Hybrid Gen4 through the Pocket WiFi dongle is tested and verified in a real home. The WiFi dongles note above has the details. With a Pocket WiFi 2.0, or an early Gen4 with the USB style dongle socket, an RS485 to network adapter on the COM port is the route. Newer SolaX models aren't covered yet.

If nothing answers, ask your installer to check the inverter's Modbus address. It is usually 1.

If you have a SolaX Gen2 or Gen3 system and would like to help us test, email us at gday@rayhub.com.au.

There is more in our SolaX monitoring guide.

Solis Workshop tested

This brand is tested in our workshop. It has not run in a real home yet. These steps are for Solis hybrid inverters that run a battery, such as the S6-EH1P and S6-EH3P.

We don't have confirmed menu steps for Solis yet.

The logger stick plugged into your inverter decides whether RayHub can read through it. Some sticks, such as the S2-WL-ST, can share readings on your home network once Solis support has updated them. Others only talk to the Solis cloud app.

Recent firmware updates for some Solis logger sticks turn off these local readings. The Solis app keeps working, so the change is easy to miss.

The dependable route is an RS485 to WiFi adapter, such as the Elfin EW11, set to Modbus TCP mode and wired to the inverter's RS485 port. Ask your installer for one. Give RayHub the adapter's IP address. No port number is needed.

A Solis logger stick allows one Modbus connection at a time. If another system already uses it, RayHub can't connect.

If nothing answers, ask your installer to check that the inverter's Modbus address is set to 1.

Solis inverters without a battery work differently inside. These steps don't cover them yet.

If you have a Solis system and would like to help us test, email us at gday@rayhub.com.au.

There is more in our Solis monitoring guide.

SMA Workshop tested

This brand is tested in our workshop. It has not run in a real home yet. These steps are for SMA Sunny Boy and Sunny Tripower inverters, and the Sunny Tripower Smart Energy with its battery.

We don't have confirmed menu steps for SMA yet.

The setting is in the inverter's own web page. Your installer signs in as Installer and switches on the Modbus TCP server. Give RayHub the inverter's IP address. No port number is needed.

On SMA inverters RayHub updates your numbers every 10 seconds. SMA asks for this gap to keep the inverter running smoothly.

Grid readings need an SMA Energy Meter connected to your inverter.

Resetting the inverter to its factory settings switches Modbus off again. If your numbers stop after a reset, ask your installer to switch it back on.

If you have an SMA system and would like to help us test, email us at gday@rayhub.com.au.

There is more in our SMA monitoring guide.

Growatt Workshop tested

This brand is tested in our workshop. It has not run in a real home yet. These steps are for Growatt MIN XH and MOD XH hybrid inverters.

We don't have confirmed menu steps for Growatt yet.

Most Growatt WiFi sticks only talk to the Growatt cloud app, so RayHub can't read through them. The ShineWiLan-X2 stick is the one that can. Check its label for X2 at the end of the name. Give RayHub the stick's IP address. No port number is needed.

If your stick isn't an X2, or readings through it drop out, ask your installer for an RS485 to WiFi adapter, such as the Elfin EW11, set to Modbus TCP mode. Give RayHub the adapter's IP address. No port number is needed.

If nothing answers, ask your installer to check that the inverter's Modbus address is set to 1.

The second generation MIN TL-XH2 and the SPH and SPA models work differently inside. These steps don't cover them yet.

Growatt SPF off-grid inverters aren't covered. Please don't connect RayHub to one.

If you have a Growatt hybrid and would like to help us test, email us at gday@rayhub.com.au.

There is more in our Growatt monitoring guide.

If the display can't find it

  1. Check the IP address against your router's list.
  2. Check the Modbus setting is still switched on.
  3. Check the inverter and RayHub are on the same home network.
  4. Ask your solar installer.Show them this page. It is usually a couple of minutes' work for them.

Questions about connecting your inverter

Not sure if RayHub will work with your system? Email us at gday@rayhub.com.au with your inverter brand and model, and whether you have a battery.

  • Which solar inverters does RayHub work with?

    Sigenergy, SolaX Hybrid Gen4, Sungrow, Fronius Primo, GoodWe hybrid and Victron are verified in a real home. Seven more brands are built and tested in our workshop and have not run in a real home yet. They are SolarEdge, Deye / Sunsynk, AlphaESS, Fox ESS, Solis, SMA and Growatt. The brand sections on this page say which models each set of steps covers.

  • Do I need to switch Modbus on to connect my inverter?

    Most inverters need it. Modbus is how your inverter shares its readings with other devices on your home network, and it is often switched off when the inverter is installed. RayHub only reads. It doesn't change how your solar runs. The Modbus page explains it brand by brand.

  • Does switching on Modbus change Fronius Solar.web?

    No. Solar.web keeps working as before. The Modbus settings only affect devices on your home network that read your inverter.

  • How do I find my solar inverter's IP address?

    Open your inverter's app and look for a page called Network, Communication or WiFi. If it isn't there, open your internet router's app or settings page and look for a connected device with your inverter's brand in its name. Finding the IP address has the steps.

  • Do I need an electrician or solar installer to connect RayHub?

    Not for Sigenergy. You can switch the setting on yourself in the mySigen app. For several other brands your solar installer switches the setting on or fits a small adapter, and the brand sections say which. RayHub itself runs from your own 5 V USB-C power adapter, so there is no wiring to do.

  • Does my inverter need to be on the same WiFi as RayHub?

    Yes. RayHub joins your home WiFi, and your inverter must be on that same home network, by WiFi or by cable. If your inverter is on its own separate network, RayHub can't reach it.

  • What if RayHub can't find my inverter?

    Check the IP address against your router's list, check the Modbus setting is still switched on, and check the inverter and RayHub are on the same home network. If it still isn't found, ask your solar installer. The help page covers what to do when the numbers look wrong.

Read next