Breaking Change ZWave JS UI (> 2024-11-29)

[MickLesk]

On 2024-11-29 a breaking change was introduced in ZWave JS UI. (#585)
ZWave JS UI is now operated via additional Envoirement values.

After these steps have been performed, it will be possible to simply execute the “update” statement again.

Please note the following steps before updating:

1. Do an Backup of your installation:

cp -r /opt/zwave-js-ui /opt/zwave-js-ui_bak

2. Remove old folder & create new folder

rm -rf /opt/zwave-js-ui
mkdir -p /opt/zwave-js-ui
mkdir -p /opt/zwave_store

3. Move your old storage files to this path

cp -r /opt/zwave-js-ui_bak/store/*  /opt/zwave_store

4. Enter Main Folder:

cd /opt/zwave-js-ui

5. Update Package:

RELEASE=$(curl -s https://api.github.com/repos/zwave-js/zwave-js-ui/releases/latest | grep "tag_name" | awk '{print substr($2, 2, length($2)-3) }')
wget -q https://github.com/zwave-js/zwave-js-ui/releases/download/${RELEASE}/zwave-js-ui-${RELEASE}-linux.zip
unzip -q zwave-js-ui-${RELEASE}-linux.zip

6. Create .env File:

cat <<EOF >/opt/.env
ZWAVEJS_EXTERNAL_CONFIG=/opt/zwave_store/.config-db
STORE_DIR=/opt/zwave_store
EOF

7. Update Service

nano /etc/systemd/system/zwave-js-ui.service

Check [Service] and add or change missing:

User=root
WorkingDirectory=/opt/zwave-js-ui
ExecStart=/opt/zwave-js-ui/zwave-js-ui-linux
EnvironmentFile=/opt/.env