🔥 Launch offer — Pylon-Monitor V2 €59 €39 · First 100 orders only · Ends August 31 →
Designed & made in France
HOME ASSISTANT8 min read

Pylontech in Home Assistant: The Complete MQTT & REST Integration Guide

Two integration paths, both built into the firmware, neither requiring a custom component. Here's exactly how MQTT auto-discovery and the REST platform work, and which one you should actually use.

Two ways in, both already built into the firmware

Ask ten people how they'd connect a Pylontech battery to Home Assistant and you'll get ten different half-answers involving custom components, HACS repositories, or YAML someone copy-pasted from a forum three years ago. With Pylon-Monitor there's no guessing: the device ships with two integration paths built directly into the firmware, and neither one requires installing anything on the Home Assistant side.

Both read from the same underlying data — the battery's Console port — so the choice isn't about capability, it's about what you already have running.

Option 1 — MQTT auto-discovery, the fast path

If Home Assistant already has the Mosquitto broker add-on running (most installations do), this is the option to use. Enter the broker's IP, port, username and password on the device's Settings page, save, and within about five seconds ten sensors show up automatically under Settings → Devices & Services → MQTT — grouped into a single device card called Pylon-Monitor. No YAML, no restart, no manually defined entities.

The ten sensors: SOC, SOH, voltage, current, power, battery temperature, MOSFET temperature, charge cycles, battery state, and cell imbalance. Plus one extra signal that matters more than people expect: an availability topic backed by a proper MQTT Last-Will-and-Testament, so every sensor correctly greys out in Home Assistant the moment the device loses power or WiFi — instead of silently freezing on its last known value, which is the failure mode that actually burns people (an alarm that never fires because the "last known SOC" looked fine).

Pylon-Monitor Settings page with real MQTT Home Assistant broker configuration fields filled in
Four fields — broker IP, port, username, password — is the entire MQTT setup on the device side.
Tip: create a dedicated MQTT user for the device (in the Mosquitto add-on config or Home Assistant's People & add-ons settings) instead of reusing your own login. It costs one extra minute and means you can revoke the device's access independently later.

Option 2 — REST, if you don't run MQTT

No broker, no problem. Home Assistant's built-in rest platform can poll the device's /api.json endpoint directly every 30 seconds and create six sensors — SOC, SOH, voltage, current, power and state. The YAML block isn't something you have to write from scratch: the device's own Settings page generates it for you, with your current IP already filled in. Copy, paste into configuration.yaml, restart Home Assistant.

Home Assistant REST YAML configuration block generated automatically by the Pylon-Monitor device for Pylontech sensors
The REST YAML block, generated on-device with the correct IP already filled in — nothing to type from memory.
Don't run both for the same sensor. Enabling MQTT auto-discovery and also adding the REST block creates duplicate entities for the same values. Pick one — MQTT already covers everything REST does, plus four more sensors and the availability signal, so there's rarely a reason to combine them.

Which one should you actually pick?

What to actually do with the sensors

Ten (or six) new sensors on their own are just numbers on a card. A few automation ideas that turn them into something useful:

For a deeper read on what these numbers mean and which ones deserve an actual alarm (versus which are just background noise), see Pylontech Diagnostics 101.

Quick troubleshooting

Don't use Home Assistant?

Everything above rides on the same /api.json endpoint and MQTT topics that power Jeedom, Node-RED, Domoticz and openHAB integrations too — see every other way to connect a Pylontech battery to a smart home platform if Home Assistant isn't your stack.

Pylon-Monitor ships with both integrations built in — MQTT auto-discovery and the REST YAML generator are already on the device, ready the moment you plug it in.

Order now — €39 One-time purchase, €39 incl. VAT — no subscription.