DEYE-INVERTER-MQTT(1)

🌸 NAME 🌸

okay bestie, meet deye-inverter-mqtt — it's the bridge between Deye solar inverters and MQTT. this is the deye-inverter-mqtt(1) manual page, living in the User Commands section, and it's here to make your solar data go brrr. 💖

---

✨ SYNOPSIS ✨

run it like this, no cap:

deye-inverter-mqtt
deye-inverter-mqtt [logger-index] r register
deye-inverter-mqtt [logger-index] w register value

---

💖 DESCRIPTION 💖

deye-inverter-mqtt reads Deye solar inverter metrics over Modbus TCP (directly or via a Solarman/Deye logger stick) and publishes them to an MQTT broker. it also supports Home Assistant MQTT discovery and can write configuration registers back to the inverter. it's giving full-stack solar whisperer. 🔥

called with no arguments, it runs as a foreground daemon, continuously polling the configured inverter(s) and publishing readings to MQTT. main character energy fr fr. 👑

called with a r or w command, it performs a single Modbus register read or write and exits. the optional logger-index (1-based) selects which configured logger to address, when more than one is configured; it defaults to the first logger. so if you got multiple loggers, you can point at the one you want — otherwise it just picks the first one. simple. 💅

---

🎀 CONFIGURATION 🎀

configuration is supplied through environment variables, documented in /etc/deye-inverter-mqtt/config.env. that file is read on every start, both when the command is run from a shell and when it is run through the bundled systemd service, unless DEYE_LOGGER_SERIAL_NUMBER is already set in the environment, in which case the whole configuration is taken from the environment. yes bestie, env vars said "i'll take it from here." 🙈

a config.env in the current directory, if present, is read in preference to the one in /etc. variables already present in the environment are never overwritten by the file. the env stays winning, periodt. ✨

---

🌈 ENVIRONMENT 🌈

• DEYE_CONFIG_FILE — Path of the configuration file to read, in preference to ./config.env and /etc/deye-inverter-mqtt/config.env. A missing file is not an error, in which case the configuration is taken from the environment alone. so if the file ghosts you, it's fine — env vars got your back. 🫶

---

🦋 FILES 🦋

• /etc/deye-inverter-mqtt/config.env — Runtime configuration (MQTT broker, inverter connection, sensor groups). this is the main config baddie. 💜

---

👑 SEE ALSO 👑

the full documentation and list of supported inverters and configuration variables is available at https://github.com/kbialek/deye-inverter-mqtt. go read it, iykyk. 📚

---

and that's the vibe check: this page is deye-inverter-mqtt, from July 2026, and it's the DEYE-INVERTER-MQTT(1) manual. slay, bestie 💅✨🎀