---
title: "FoxESS - Modbus"
description: "FoxESS - Modbus is a Marketplace integration for Home Assistant. It has 1.3k installs sharing analytics, works locally and was last updated September 21, 2026."
canonical: "https://vulpo.app/integrations/marketplace/nathanmarlor-foxess-modbus"
url: "https://vulpo.app/integrations/marketplace/nathanmarlor-foxess-modbus.md"
last-updated: "2026-10-22"
version: "1.4"
---

# FoxESS - Modbus

> FoxESS - Modbus is a Marketplace integration for Home Assistant. It has 1.3k installs sharing analytics, works locally and was last updated September 21, 2026.

FoxESS - Modbus is an integration that connects Home Assistant to FoxESS inverters locally over Modbus, without the cloud. It provides real-time readings and control through binary sensors, numbers, selects and sensors, rather than cloud data that updates about every 5 minutes. Depending on the inverter model, it can also set charge periods, work mode and minimum and maximum state of charge. The connection can run over a network adapter or a USB serial device, and the options cover the poll rate, rounding of sensor values to reduce database size, and older inverter firmware versions. It also offers a service to write any Modbus address, services to update charge periods, and repair notices for connection errors or invalid registers. Setup is done in the UI, with an option to configure the Energy Dashboard automatically, and it requires a direct Modbus connection to the inverter.

Automatic summary of the README and code of nathanmarlor/foxess\_modbus. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=nathanmarlor&repository=foxess_modbus&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=nathanmarlor&repository=foxess_modbus&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Select adapter type

- **Adapter Type**

### Select adapter model

- **Adapter Model**

### Tcp adapter

- **Protocol**
- **Protocol**
- **Inverter hostname / IP address**
- **Adapter hostname / IP address**
- **Adapter port**
- **Inverter slave ID**: This can be set from Settings -\> Communication in the inverter menu

### Serial adapter

- **USB serial device**
- **Inverter slave ID**: This can be set from Settings -\> Communication in the inverter menu

### Friendly name

- **Friendly Name**: This is added to the end of all entity names, e.g. 'PV1 Power (Your Friendly Name)'
- **Use the Friendly Name to auto-generate a prefix for all entity IDs**
- **Entity ID Prefix**: Added as a prefix to all of this inverter's entity IDs

### Energy

- **Automatically configure the Energy Dashboard**

### After setup

- **Protocol**
- **Protocol**
- **Inverter hostname / IP address**
- **Adapter hostname / IP address**
- **Adapter port**
- **Inverter slave ID**: This can be set from Settings -\> Communication in the inverter menu
- **USB serial device**
- **Inverter slave ID**: This can be set from Settings -\> Communication in the inverter menu
- **Inverter's Manager Version**: If you're running old inverter firmware, you may be able to select it here
- **Round sensor values**: Reduces Home Assistant database size by rounding and filtering sensor values
- **Poll rate (seconds)**
- **Max read**

Texts from the code of [nathanmarlor/foxess\_modbus](https://github.com/nathanmarlor/foxess_modbus).

## Troubleshooting

- **Repair notices**: Notices it can show in Settings, Repairs:
  Connection Error, Invalid registers detected

## From the README

> This project is not endorsed by, directly affiliated with, maintained, authorized, or sponsored by FoxESS

From the README of [nathanmarlor/foxess\_modbus](https://github.com/nathanmarlor/foxess_modbus#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries
- Brand: [FoxESS](https://vulpo.app/integrations/foxess.md)
- Number: 1.3k installs sharing analytics; 340 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v1.15.0, last updated September 21, 2026
- Domain: `foxess_modbus`
- Source: <https://github.com/nathanmarlor/foxess_modbus>
- Issues: <https://github.com/nathanmarlor/foxess_modbus/issues>
- Screenshot: https://vulpo.app/integrations-img/7a195cca1df5767c.webp (from nathanmarlor/foxess\_modbus's README)
- Screenshot: https://vulpo.app/integrations-img/6a142e32dc54bfd9.webp (from nathanmarlor/foxess\_modbus's README)
- Screenshot: https://vulpo.app/integrations-img/3431786c1e93bf59.webp (from nathanmarlor/foxess\_modbus's README)

In Vulpo: Select card, Chart card, Apple Watch

## Other ways in for FoxESS

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [HA & FoxESSCloud integration](https://vulpo.app/integrations/marketplace/macxq-foxess-ha.md) | Marketplace integration | 1.5k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [FoxESSCloud API](https://vulpo.app/integrations/marketplace/softxperience-home-assistant-foxess-api.md) | Marketplace integration | 292 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [FoxESS Control](https://vulpo.app/integrations/marketplace/nicois-foxess-control.md) | Marketplace integration | 121 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [FoxESS OpenAPI](https://github.com/fruffin/home-assistant-foxess-openapi) | Marketplace integration | 46 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [FoxESS T Series](https://github.com/LucasTor/FoxESS-T-series) | Marketplace integration | 10 installs sharing analytics | Works locally | Updated in the last 6 months |

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/nathanmarlor-foxess-modbus

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/nathanmarlor-foxess-modbus
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml
