# Update Serin Controller firmware

> Check the installed firmware version, update over Wi-Fi or USB, try a pre-release build, and return to the stable release.

Source: https://serin-labs.com/controller/updates.html
Last updated: 2026-11-10

## Check the installed version

The [flash tool](https://serin-labs.com/flash.html) reads the installed firmware and version over USB before writing anything.

### HomeKit-compatible and Matter-compatible firmware

In the [web interface](https://serin-labs.com/controller/web-interface.html#open), read **Firmware** > **Installed**. Reload after an update.

### ESPHome

ESPHome firmware reports the ESPHome release it was built with. The Serin configuration has no version number of its own. Home Assistant shows it as the controller's **ESPHome Version** sensor.

## Update over Wi-Fi

HomeKit-compatible and Matter-compatible Wi-Fi updates keep the network, pairing and settings.

**Do not switch off the power during an update.** Keep the page open, and the phone awake, until it shows "Update complete! Restarting...".

1. Open the web interface and expand **Firmware**.
2. Select **Versions**. Releases for your board appear newest first: **latest** marks the newest stable release, **beta** marks a pre-release, and **installed** marks the current version. Older releases are under **Other versions**. **Release notes** opens the HomeKit-compatible release page.
3. Select a version and confirm. Your phone or computer downloads it and sends it to the controller, which verifies it and restarts. Keep the page open, the phone awake and power on until it shows "Update complete! Restarting...". The light pulses white during installation.
4. After the controller restarts, check **Installed**. Then change the mode or target temperature and confirm that the indoor unit responds.

The browser contacts the release server only when you open **Versions**. The phone or computer needs internet access, but the controller does not. If a newer release is found, the button and section show **Update available**. Installation is always manual.

If the new version cannot start, the controller restores the previous version. See [the version did not change](https://serin-labs.com/troubleshooting.html#version-unchanged).

For a failed check, install, or unchanged version, see [update troubleshooting](https://serin-labs.com/troubleshooting.html#recovery).

## Try a pre-release build

HomeKit-compatible and Matter-compatible pre-release builds are less tested than stable releases. [Back up settings](https://serin-labs.com/controller/backups.html) before trying one.

Serin's ESPHome firmware has no pre-release builds.

In **Firmware** > **Versions**, select a release tagged **beta** and confirm. With **Beta updates** on, the newest pre-release appears at the top and the page offers it as the update if it is newer than the latest stable release. The controller saves this preference. Beta releases remain available in the menu when it is off.

## Return to the stable release

Warning

**Settings may not carry over to an older version.** Before you go back, select **Device** > **Export Settings** so you can [import them again](https://serin-labs.com/controller/backups.html#export) afterward.

Turning off **Beta updates** does not change the installed version.

1. Open **Firmware** > **Versions**.
2. Select the release tagged **latest** and confirm.
3. After the restart, check **Installed** and your settings.

To install an older release, select it under **Other versions** in the same menu.

## Update over USB

Follow the [USB installation steps](https://serin-labs.com/controller/recovery.html#reset) to remove and reinstall the controller. Switch off power at the breaker and disconnect CN105 before connecting USB.

1. Connect the controller to a computer with a USB-C data cable. Open the [flash tool](https://serin-labs.com/flash.html) in Chrome, Edge, or Brave and select **Connect a device**.
2. Select the firmware already installed.
3. For a HomeKit-compatible or Matter-compatible pre-release, select **Install the pre-release build**. The box appears only when a pre-release exists for your board.
4. To keep settings on HomeKit-compatible and Matter-compatible updates, leave **Erase everything first** unchecked. Obey any reset warning for the selected build. Reinstalling ESPHome erases saved settings even with **Erase everything first** unchecked. The button reads **Reset and install**. Select the install button and leave USB connected until it finishes.

[![Flash tool firmware step with Apple Home selected and marked On the board, Install the pre-release build ticked showing version 0.2.6-beta.3, Erase everything first unticked, and an Update to 0.2.6-beta.3 button](https://serin-labs.com/assets/content/1164/media/flash-prerelease.png.ad04e9ea3cbf.webp)](https://serin-labs.com/assets/media/flash-prerelease.png)

Apple Home firmware is shown. The same pre-release option is available for Matter-compatible firmware. [View full-size screenshot](https://serin-labs.com/assets/media/flash-prerelease.png).

To return to stable over USB, leave **Install the pre-release build** unchecked. If the tool warns that it is older than the installed build, select **Install the older version anyway**, then install.

## Install a firmware file

For HomeKit-compatible or Matter-compatible firmware, use this when support supplies a file or the release server is unreachable.

1. Get the application file for your board and installed firmware. For HomeKit-compatible firmware, open **Versions** > **Release notes** or the [release page](https://github.com/akifbayram/mitsubishi-cn105-homekit/releases) and download `firmware-nanoc6.bin` or `firmware-m5atoms3-lite.bin`.
2. In **Firmware**, under **Manual .bin Upload**, select **Choose File** and pick the file. Select **Upload** and confirm.
3. Wait for "Update complete! Restarting...", then reload the page and check **Installed**.

If the controller refuses the file, follow [the upload-error checks](https://serin-labs.com/troubleshooting.html#upload-failed).

For HomeKit-compatible command-line uploads with `curl`, see the [source documentation](https://github.com/akifbayram/mitsubishi-cn105-homekit).

## ESPHome updates

- **Adopted in the ESPHome dashboard.** Select **Install** to build the current configuration and send it over Wi-Fi. This includes Serin configuration changes, even when the dashboard shows no update notice. That notice tracks ESPHome releases only.
- **Customized with the YAML generator.** The generated configuration is a copy made when you generated it. To get later changes, [generate it again](https://serin-labs.com/controller/customize-esphome.html) and install it.
- **Not adopted yet.** [Adopt it](https://serin-labs.com/esphome/setup.html#pair) to update from the dashboard, or reinstall over USB, which erases saved settings.

If an update fails or the controller stops responding, use [update recovery](https://serin-labs.com/troubleshooting.html#ota-recovery).
