How to upgrade iSG to support HA to the latest version? 【update 12/03/2025】
Since Home Assistant requires Python 3.13 support starting from version 2025.2, we have upgraded the Python version of the iSG container.
Last updated
Since Home Assistant requires Python 3.13 support starting from version 2025.2, we have upgraded the Python version of the iSG container.
Last updated
Although we have added automatic backup and restore functions to the upgrade process, we still 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.
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
Go to iSG Settings > Container Click , download the Install
After upgrading the iSG software, the device will reboot and enter the installation wizard. Please complete all the addition steps according to the procedure.
If it is a brand new iSG installation, you can skip this step. If it is an iSG that has been used before, after backing up and restoring the data, you will need to reconfigure the HA settings.
Go to iSG settings - Local HA - Start Initialization
After the configuration is complete, the HA service state should display as "Running".
You have completed the installation process. If you encounter any issues during the addition process, please contact our technical support in a timely manner through the Discord community https://discord.gg/SstkRMxnT8
1)After the upgrade, can I still use the Home Assistant ZHA Integration to add Zigbee devices?
Answer: No, after the upgrade, you can only add Zigbee devices using the Zigbee2MQTT service, and the entry point for adding devices will be directly through iSG Device - Add Device - Zigbee.