From this version onward, we've fully upgraded iSG's container architecture. Going forward, iSG's built-in Home Assistant will continuously support updates to the latest version.
Last updated
This guide is for original iSG Display only.
This guide is for users want to keep their previous iSG and HA settings. For new users without need of data backup and restoration, please just read part 3 and 5.
Go to iSG Settings > iSG Firmware / Backup > Backup iSG, and save the backup file to your USB drive.
In iSG Home Assistant, go to Settings > System > Backup, then save the backup file to your USB drive.
For detailed steps, please refer to the iSG and Home Assistant Backup Guide.
Flash the iSG image to the 64-bit version.
Refer to the Flashing iSG System Image guide for instructions.
After flashing and restarting iSG, you'll be prompted to sign in. Do not sign in yet. Instead, click Restore and select your iSG backup file from the USB drive.
After restoration, iSG will begin initializing all configurations. Most setups are completed automatically without user intervention.
The only step requiring your input is the Zigbee setup, where you’ll choose the operating mode for the Zigbee radio (Z2M is highly recommended). If you select Z2M mode, please refer to the article Firmware Update > Zigbee Firmware (USB Dongle) to update the firmware on PC.
IMPORTANT: The Zigbee radio firmware update is irreversible if you choose Z2M mode. Once applied, it cannot be changed to Direct Mode.
Afterward, plug in the dongle and proceed with the auto-configuration of the Zigbee profile.
After all configurations are complete, navigate to Settings > Local HA > Restore HA. You’ll be taken to iSG’s file manager. Select the appropriate HA backup file, and iSG will restore your built-in Home Assistant settings to their previous state.
After restoring your HA backup, the local HA status may remain in Starting. This is because the current HA instance token differs from what’s in your backup, preventing authentication. To resolve this, go to Settings > Local HA > Start Initialization.
follow the on-screen instructions to copy the token from the current HA instance.
Then, paste it into iSG’s HA Token verification page to complete the verification.
The wizard will also guide you through reconfiguring the MQTT broker. If you choose to use the default settings, simply click Next to proceed and complete the setup.
You have successfully completed the upgrade process. If you encounter any issues during setup or installation, please reach out to our technical support team through the Discord Community.
