Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Modbus Local Gateway connects Home Assistant to Modbus devices through a Modbus TCP gateway or a serial port. Register and coil layouts are described in YAML device files, which the integration maps to entities such as sensors, switches, numbers, selects, texts and date or time entities. It supports both read-only monitoring and read/write control, and everything runs locally. The gateway can be Modbus TCP, Modbus RTU over TCP, or a Home Assistant Connect AUX-2 that exposes its RS-232 serial ports over USB, so no network gateway is needed in that case. Several devices can sit behind one gateway, each appearing as its own device with an optional name prefix and an option to mark it as expected to be offline at times. Setup is done in the UI, and the integration needs the Marketplace.

Automatic summary of the README and code of timlaing/modbus_local_gateway. Something wrong, or are you the maintainer and want your own text here? Get in touch

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.

Provides

  • Switches
  • Sensors

Setting it up

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

Modbus gateway

  • Gateway typeAn AUX-2 reaches this integration over USB and proxies a serial port of its own: pick it when the Modbus devices are wired to that port rather than to the network.

Home Assistant Connect AUX-2

  • DeviceOnly AUX-2 devices adopted in Home Assistant show up here, with the serial ports they expose.

Serial port

  • Baud rate
  • Data bits
  • Serial portAUX-2 ports are RS-232: a Modbus bus on RS-485 needs an adapter between it and this port.
  • ParityNone, even or odd, as the devices on the line expect.
  • Stop bits

Modbus gateway

  • Connection type
  • Host
  • Use the pre 2026.02.0 entity idsOnly applies to entities created from now on. Existing entity ids are never changed by this integration.
  • Port
  • Restore entity ids of this integrationMoves the entities this integration named after the gateway host back onto the entity id they had before that prefix existed. Renaming entity ids breaks the automations and dashboards using them, so this only happens when you ask for it.

Also asked when changing the connection.

Texts from the code of timlaing/modbus_local_gateway.

Troubleshooting

  • DiagnosticsDownloads a diagnostics file to attach to a bug report.

Shows in Vulpo

Quick Toggle card, Select card, Chart card, Apple Watch, Control Center.

Information

Installs
57 sharing analytics
GitHub stars
49
Connection
Works locally
Upkeep
Updated in the last 6 months
Version
v2026.10.7,
Category
Hubs and protocols, Building automation
Kind
Marketplace integration
Needs
Needs the Marketplace (HACS on 2026.10 and older)
Domain
modbus_local_gateway

You might also like

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. About these numbers