How to upgrade iSG to support HA to the latest version? 【update 20/03/2025】

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

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. System Update

1）System Backup

Please click on backup before any update. The system will guide you to back up iSG, Zigbee, Z-wave, Device Database, and Home assistant. You can click on Last backup time to view the previous backup log.

2）Update iSG、 Continer and Image

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

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

3）Restore Data

Click “Restore System” to enter the Data Restore Wizard.

• If you have backed up your data in the first step, just click Confirm here.

• If you backed up manually, you can save the backup data to a USB drive, then select the USB drive in the Data Restore Wizard and click Confirm

4）System Configuration

Click “System Configuration” to enter the system configuration wizard, which will help you configure the necessary information for Home Assistant to connect to iSG. Please be sure to configure each step carefully. At the same time, it will also automatically help you configure all the parameters required by Zigbee2MQTT.