How to upgrade iSG to support HA to the latest version? 【update 01/07/2025】

Since Home Assistant requires Python 3.13 support starting from version 2025.3, we have upgraded the Python version of the iSG container.

Prerequisites:

  1. iSG Upgrade: If you are using the original iSG device (which relies on an external Zigbee dongle), please ensure your iSG has been upgraded to the 64-bit version. For detailed instructions, refer to: https://kb.linknlink.com/isg/faq/firmware-update/upgrading-original-isg-display-to-support-ha-to-the-latest-version

  2. Zigbee Dongle Mode: The Zigbee dongle must be switched to ZHA mode before proceeding. Please follow the guide here: https://kb.linknlink.com/isg/settings/firmware-updates/zigbee-firmware-usb-dongle

  3. Power & Network Requirements: During the upgrade process, do not disconnect the power or internet connection. This update includes major changes and may take up to 2 hours to complete. Please be patient.

1. Manual BACKUP

Although we have added automatic backup and restore functions to the upgrade process, we do recommend that users manually back up their files: 1) Backup iSG Go to iSG Settings - iSG Firmware / backup - Backup iSG, save backup file to USB drive

2) Backup Home Assistant · Use PC browser to access home assistant, iSG IP:8123 · In the left sidebar, click “Settings”. · On the “Settings” page, locate and click “System”. · click “Backups” to access the backup management page · Click the “Create Backup” button in the bottom-right corner ` Wait for the Backup to Complete, Download the backup to PC

3) Backup Zigbee · Log in to Zigbee2MQTT, Open your browser, enter your Zigbee2MQTT instance address (e.g., http://iSG IP:8080) · In the topbar, click “Settings”. · Select "Tools" and Click " Request_z2m_backup" · Click "download_z2m_backup", and save backup to PC

4) Backup Z-wave · Use PC browser to access the Z-Wave JS UI management interface (e.g., http://iSG IP:8091). · Go to Settings > Backup & Restore. · Click Download Backup to save the .tar.gz backup file.

2. Update iSG

1)Online update If your iSG version is kept up to date, you can go to iSG settings - iSG Firmware, find the new version in the details page on the right, and then click "Download Update" to update the firmware. After the update, the device will automatically restart.

2)Manual Update Go to iSG system - storage - usb drive, find the iSG update APK file and select to install.

Please refer to the "How to use USB drive to Update firmware" guidance. https://kb.linknlink.com/isg/faq/firmware-update/how-to-use-usb-drive-to-update-isg-firmware

3. A new way to update iSG

Starting from version 20145, iSG will use a new update method. The system update is divided into three parts: iSG, Container, and Image. If there is any update in these three parts, an icon for downloading updates will appear in the upper right column of the homepage. Clicking the icon will directly lead to the update page.

You can also go directly to iSG Settings - System Update to find the update page

4. Container Update

1) Online Update If you see an upgrade prompt, please click "New Version" to download the latest firmware, and then click "Update" to enter the upgrade wizard. After each upgrade, iSG will restart to take effect.

2) Manual Update You can also download the firmware to your computer from the upgrade webpage first, and then copy it to a USB flash drive. Click "Update" directly, enter the upgrade wizard, click the USB flash drive icon on the page, and select the corresponding upgrade firmware from the USB flash drive. Remember not to change the name of the downloaded upgrade file, otherwise the upgrade may not be successful.

5. Image Update

Click “Update” to enter the image update.

  • It will automaticlly backup Home Assistant, Zigbee2Mqtt and Z-wave JS UI

  • It will start a fresh installation of all the programs

Note!

Please keep your system powered and internet connected. It will take 2 hours to finish installation, please be patient!

  • Finally, it will auto restore backups to finish update.

Last updated