# 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.

---

**Documents**

- [EP1 vs EPL: Which Sensor is Right for You?](https://docs.everythingsmart.io/s/products/doc/ep1-vs-epl-which-sensor-is-right-for-you-5B3RxiY3Kp)
- [Everything Presence One (EP1)](https://docs.everythingsmart.io/s/products/doc/everything-presence-one-ep1-3R178yZSUP)
- [Everything Presence Pro](https://docs.everythingsmart.io/s/products/doc/everything-presence-pro-nh3fIXmow9)
- [Everything Presence Lite (EPL)](https://docs.everythingsmart.io/s/products/doc/everything-presence-lite-epl-ZVnBzYzuX2)
- [Zone Configurator](https://docs.everythingsmart.io/s/products/doc/zone-configurator-93b9scGsa2)
- [Knowledge Base Articles](https://docs.everythingsmart.io/s/products/doc/knowledge-base-articles-KnRRmk4zvt)