PYMODBUS.SIMULATOR(1)

📦 version 3.14.0, in ubuntu stonking

💖 PYMODBUS.SIMULATOR 💖

okay bestie, so this is a page from the User Commands manual, and it's literally about the cutest little Modbus server sim you've ever met. grab a strawberry 🍓 and let's go.

✨ NAME ✨

pymodbus.simulator — a Modbus server simulator that comes with a REST API and a web interface. yes, both. she does it all. 👑

🌸 SYNOPSIS 🌸

pymodbus.simulator [--modbus_server SERVER] [--modbus_device DEVICE]
[--http_host HOST] [--http_port PORT] [--log LEVEL] [--log_file FILE]
[--json_file FILE] [--custom_actions_module MODULE]

🦋 DESCRIPTION 🦋

so pymodbus.simulator spins up a Modbus server simulator, and it's not just a server — it also brings an HTTP REST API and a web console along for the ride. main character energy fr.

basically it's a little trio working together:

  • a datastore simulator (this is the part that defines registers and how they behave, iykyk)
  • a Modbus server
  • an HTTP server that gives you an online console you can just open in your browser 🌈

💅 OPTIONS 💅

  • --modbus_server SERVER — picks SERVER from server_list in the JSON config file. choose your fighter.
  • --modbus_device DEVICE — picks DEVICE from device_list in the JSON config file.
  • --http_host HOST — binds the HTTP server to HOST.
  • --http_port PORT — binds the HTTP server to PORT. default is 8081. 🎀
  • --log LEVEL — sets the log level. one of: critical, error, warning, info, debug. default is info.
  • --log_file FILE — writes the server log to FILE. default is server.log.
  • --json_file FILE — loads the simulator config from FILE. default is the built-in setup.json.
  • --custom_actions_module MODULE — a Python file that gives you custom register actions. default is none. no cap, none.
ngl bestie, the --http_port PORT default of 8081 and the --log_file FILE default of server.log are the two defaults you'll bump into the most, so keep them in your notes app 📝

👀 SEE ALSO 👀

the pymodbus documentation is available in the python-pymodbus-doc package. go read her, she's iconic.

okay that's the whole page and you ate that, fr fr. big kiss, stay slaying, and remember: every simulator deserves a vibe check before you ship her 💜

this page came from the pymodbus manual, dated 2026-05-24 — and that's the tea, bestie 🫶✨

📦 where this page comes from