# Fox ESS Device

**URL:** <https://community.homey.app/t/fox-ess-device/143628>\
**Category:** Energy\
**Created:** [October 1, 2025, 1:12pm UTC](https://community.homey.app/t/fox-ess-device/143628 "2025-10-01T13:12:43Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![Carter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/carter/32/123116_2.png) [@Carter](https://community.homey.app/u/Carter)\
**Post date:** [October 1, 2025, 1:12pm UTC](https://community.homey.app/t/fox-ess-device/143628/1 "2025-10-01T13:12:43Z")

</div>

Hello,

I’m new to Homey, I am wanting to add my solar/battery system to myhomey however I don’t see any app so can someone please offer help/support on what my options are. I use the FoxCloud app on my iphone but is there anything I can use?

I have a Home Pro Mini (New version) with a Bridge for extra devices/features.

Thank you

---

<div class="post-metadata">

**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\
**Post date:** [October 1, 2025, 1:29pm UTC](https://community.homey.app/t/fox-ess-device/143628/2 "2025-10-01T13:29:13Z")

</div>

Possible options:

- Wait for an app for Homey to appear (might be tomorrow, might be never)
- Set up a Home Assistant server with the [FoxESSCloud integration](https://github.com/SoftXperience/home-assistant-foxess-api) and use the [Homey Home Assistant app](https://homey.app/en-nl/app/io.home-assistant.community/Home-Assistant-Community/) to pull the data into Homey
- Check if your inverter support Modbus; if so, with some additional hardware (documented [here](https://github.com/nathanmarlor/foxess_modbus/wiki/Direct-Ethernet-Connection-to-Inverter)) and the [Homey Modbus app](https://homey.app/en-nl/app/org.modbus/Modbus/) you _may_ (no guarantees) get it working with Homey.

---

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [October 1, 2025, 6:27pm UTC](https://community.homey.app/t/fox-ess-device/143628/3 "2025-10-01T18:27:20Z")

</div>

And you can follow the link presented for missing device apps; if and when someone creates an app is up to the stars and moon:

 ![Screenshot from 2025-10-01 20-24-05](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/7/8/78d96073ef4e68481d0d3b26c2b1cddcf7088a30.png)

I’ve learned H.A. is your best friend, also for (quickly) adding missing stuff to Homey (amongst many other things!):

> [@robertklep](#):
>
> Set up a Home Assistant server with the [FoxESSCloud integration](https://github.com/SoftXperience/home-assistant-foxess-api) and use the [Homey Home Assistant app](https://homey.app/en-nl/app/io.home-assistant.community/Home-Assistant-Community/) to pull the data into Homey

---

<div class="post-metadata">

**Author:** ![Carter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/carter/32/123116_2.png) [@Carter](https://community.homey.app/u/Carter)\
**Post date:** [October 2, 2025, 8:31am UTC](https://community.homey.app/t/fox-ess-device/143628/4 "2025-10-02T08:31:52Z")

</div>

Thank you both. I will pull out my pi and install HA.

---

<div class="post-metadata">

**Author:** ![GrayV8](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/grayv8/32/178444_2.png) [@GrayV8](https://community.homey.app/u/GrayV8)\
**Post date:** [April 9, 2026, 1:48am UTC](https://community.homey.app/t/fox-ess-device/143628/5 "2026-04-09T01:48:16Z")

</div>

Hi @Carter you might now be quite happy with the FoxESS\>HA\>Homey solution, if so, no issues. Just an fyi that i have built a rudimentary Device locally for my FoxESS inverter via the Homey v3 SDK, but this custom app is really only for me to use and i have not published fully to the Homey App store, etc. I can however provide the node.js package to you, so you can use homey cli to install it and update it as you see fit.

The app has settings for API Key and Serial Number, and polling time 1-300 seconds; it pulls data from the [foxesscloud.com](http://foxesscloud.com) website, not directly from the inverter fyi. The cloud data is only updated every 5mins also, but that’s fine for me as I’m not using it to drive buying/selling power, just for monitoring and basic flow triggers, all of which is working really well for me so far.

Note that I built this via the FoxESS API home page, and Perplexity and ChatGPT ‘Codex’ tools, so I am not a proper programmer by any stretch of the imagination; however, if I can do it, then anyone can these days basically…Codex is an amazing tool!

Cheers, Gray.

 ![Screenshot 2026-04-09 114736](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/6/a/6ade1c7d531b7cfb7bf8c7bac108371eea3122b9.jpeg)

---

<div class="post-metadata">

**Author:** ![Carter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/carter/32/123116_2.png) [@Carter](https://community.homey.app/u/Carter)\
**Post date:** [April 10, 2026, 7:53am UTC](https://community.homey.app/t/fox-ess-device/143628/6 "2026-04-10T07:53:58Z")

</div>

Hi, yes I’d love to give it a try. The HA to Homey is ok but I would prefer a “in house” homey option. If you could send me the node.js I’d be grateful.

Cheers

---

<div class="post-metadata">

**Author:** ![GrayV8](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/grayv8/32/178444_2.png) [@GrayV8](https://community.homey.app/u/GrayV8)\
**Post date:** [April 11, 2026, 3:29am UTC](https://community.homey.app/t/fox-ess-device/143628/7 "2026-04-11T03:29:53Z")

</div>

@Carter Please see [GitHub - crazy-gray-v8/foxesscloud-homey: FoxESS Cloud API query from Homey using SDK v3 to retrieve Inverter and Battery data. · GitHub](https://github.com/crazy-gray-v8/foxesscloud-homey) for the code. I’ve also got another ‘snippets’ project which I used during scaffolding / analysis, so take a quick look at that too. Let me know if any major issues…Cheers, Gray.

---

<div class="post-metadata">

**Author:** ![Carter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/carter/32/123116_2.png) [@Carter](https://community.homey.app/u/Carter)\
**Post date:** [April 13, 2026, 1:41am UTC](https://community.homey.app/t/fox-ess-device/143628/8 "2026-04-13T01:41:01Z")

</div>

OK, Have it installed on my Homey Pro just fine. I have added my API and Serial number and can see it working but need to give it sometime to see how it populates etc.

I’ll keep in touch as this is a great start to having FoxESS on Homey and hopfully admin will take note.

EDIT:

@GrayV8 I’ve had it running since install but I’m finding these issues

Battry SoC - last updated 56 years ago  
Battery Energy - last updated 56 years ago  
Solar Gen. last updated 8 hours ago (time of install)  
Home Use: updating fine, showing correct information  
Batt. Charging: updating fine, showing correct information  
Batt. Discharging: last updated 8 hours ago (time of install)  
Grid Feed-in: showing nothing but updated within the last 15 minutes  
Grid Use: updating fine, showing correct information

I’ve clicked the ‘Refresh Now’ under the maintenance section but its not fixing the sections not updating. I’ve left the poll intervel at 300 seconds.

---

<div class="post-metadata">

**Author:** ![GrayV8](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/grayv8/32/178444_2.png) [@GrayV8](https://community.homey.app/u/GrayV8)\
**Post date:** [April 13, 2026, 12:54pm UTC](https://community.homey.app/t/fox-ess-device/143628/9 "2026-04-13T12:54:17Z")

</div>

Hey @Carter , well at least it is accessing some data etc, that’s a pretty good start. It is odd that some of the fields are not displaying but it’s likely due to differences in the inverter h/w, s/w versions, or whatever.

Either way, you’re probably best to check out the code snippets I mentioned in the other repo I have on GH and use the API call which returns all of the available fields for your particular set up, as the FoxESS API page specifically states that these will differ. Then you can see the name of each field you want to grab and make the custom code changes as necessary.

I’m surprised that SoC doesn’t show but then I did actually have issues with that field; in my python code it had to be named SoC\_1 but in the js code it had to be just SoC.

Btw, I think when a given Homey device doesn’t show an updated time for a given data element it can often mean it just happens to be the same value as last time, not that it actually hasn’t updated it. At least, that’s what I think I’ve seen here…

See how you go, keep me posted…

---

<div class="post-metadata">

**Author:** ![Ward\_Van\_Beneden](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ward_van_beneden/32/120990_2.png) [@Ward\_Van\_Beneden](https://community.homey.app/u/Ward_Van_Beneden)\
**Post date:** [May 16, 2026, 10:09pm UTC](https://community.homey.app/t/fox-ess-device/143628/10 "2026-05-16T22:09:12Z")

</div>

Hey @Carter , have you ever managed to fix it? I am having the same exact issue. Everything is correct except for the Battery SoC and Battery Energy.

@GrayV8 Thanks for creating this app, this is great. I had everything running well in Home Assistant but since I am switching to Homey I was looking for a way to get Fox to work too.

Update: I solved it !

In drivers\foxess\_inverter\device.js You need to replace"SoC\_1 with Soc. This fixed the issue for me, now it is completely working.

Also changed the battery capacity to 5.12 since I have 2 HV2600 batteries.

 ![Screenshot_2026-05-17-00-54-16-138_app.homey](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/f/3/f3d20cfd8d3167d5809b28c278b0ddf32492a709.jpeg)

Update 2: Since I was installing this when it was dark outside I didn’t see that the solar generated power also wasn’t working.

In drivers/foxess\_inverter/device.js, I changed meterPower2 to pvPower.  
And did the same in lib/foxess-client.js

---

<div class="post-metadata">

**Author:** ![GrayV8](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/grayv8/32/178444_2.png) [@GrayV8](https://community.homey.app/u/GrayV8)\
**Post date:** [May 18, 2026, 12:05am UTC](https://community.homey.app/t/fox-ess-device/143628/11 "2026-05-18T00:05:12Z")

</div>

Hi @Ward_Van_Beneden great that you solved the issue; yes, I was about to reply to point to the SOC labelling being a little different apparently across different inverters by the looks of things, I’m glad you resolved this yourself. Yes, the advanced settings value contains the size of your batteries, so this must be manually set so that the kwh available is calculated correctly based on the SoC. And yes, my system is AC coupled to a GoodWe solar pv inverter so my PV data is not fed on the value for PV per single inverter DC connected systems, glad you fixed that too.

---

<div class="post-metadata">

**Author:** ![RM\_de\_Gruijter](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rm_de_gruijter/32/120762_2.png) [@RM\_de\_Gruijter](https://community.homey.app/u/RM_de_Gruijter)\
**Post date:** [September 16, 2026, 11:22am UTC](https://community.homey.app/t/fox-ess-device/143628/12 "2026-09-16T11:22:56Z")

</div>

FYI:

> [@\[APP\]\[Pro&Cloud\]\[Official\] FoxESS - Test accounts needed for development](https://community.homey.app/t/app-pro-cloud-official-foxess-test-accounts-needed-for-development/159666):
>
> I will start work on an official FoxESS app. It will be able to monitor solar panel inverters, main meters, home storage batteries and heat pumps via the FoxESS cloud. To be able to develop and test the app I need FoxESS accounts. So if you are willing to (temporarily) share your account details with me, please send me a message. hugs
