Firmware Updates

Zone Configurator includes a built-in firmware updater that uses a local HTTP proxy to deliver firmware to Everything Presence devices. This avoids HTTPS memory limits on ESP devices and shows live progress during installs.

How It Works

  • Local firmware proxy: The add-on serves firmware over HTTP on your LAN.

  • Device-reported build config: Updates are only allowed when the device reports its build flags (no inference).

  • Progress tracking: The update entity reports install percentage and the UI waits for the reboot to complete.

Update a Device

  1. Open Settings > Firmware Updates.

  2. Select your device.

  3. Click Check for Updates.

  4. Install the latest firmware (or Reinstall if you are already on the latest).

  5. Watch progress and wait for the reboot to finish.

Reinstall or Roll Back

The updater keeps a cache of recent firmware versions per device. You can install a cached version from the firmware cache list to roll back.

Cache Retention

You can control how many distinct firmware versions are kept per device (default: 3).

Network & Port Settings

  • Default LAN firmware port is 38080.

  • Home Assistant add-on: set firmware_lan_port in the add-on Configuration tab.

  • Docker: map the port and set FIRMWARE_LAN_PORT.

If the device cannot reach the add-on, set the LAN IP override inside Zone Configurator or FIRMWARE_LAN_IP in Docker.

Troubleshooting

Build configuration unavailable The device firmware does not expose build flags yet. Flash the latest firmware via USB or ESPHome, then retry.

No update progress Re-sync entities so the firmware update entity is mapped.

Device does not come back online Check Home Assistant for the update entity state and verify the device can reach the LAN firmware port.