Skip to content

LumaConfig CLI

LumaConfig CLI is a Python utility for managing multiple Luma devices.

The complete documentation, installation guide and command reference are maintained in the GitHub repository.

Open the README on GitHub

Example use inside Home Assistant

LumaConfig CLI can be run from Home Assistant to perform maintenance tasks across multiple Luma modules without having to connect to each device individually.

Export statistics from all devices

Statistics can be collected from all configured devices in a single operation. This is useful for diagnostics, troubleshooting, and reviewing the state of a complete installation.

Update firmware on multiple devices

LumaConfig CLI can also update the firmware of multiple modules in a single operation.

For an individual device, a firmware update can normally be performed using the LumaConfig web interface. When several devices need the same firmware update, however, using the CLI is considerably faster than updating each module separately.

Legacy modules

Some installations may contain legacy Automate modules. When working with these modules, use the command-line option -b automate instead of -b luma.