XorMon v2.2.0 requires Node.js v24.
Node.js v20 is no longer supported by XorMon, it will reach end of support in April 2026.

General steps

• Backup XorMon host (clone/snapshot)
• Stop XorMon
• Remove current Node.js
• Install Node.js v24
• Enable port 443 for Node.js
• Start XorMon
• Upgrade to XorMon v2.2.0+

1. Node.js version check

   If the version is v24.x, then everything is fine, you do not need to continue and you can upgrade XorMon right away.

   node -v
     v24.13.1




2. Stop XorMon

   Run following commands as xormon
   

   su - xormon
   cd ~/xormon-ng
   ./xormon.sh stop
   
   # This is a must once XorMon is down!
   cd ~/xormon-ng/server-nest
   npx pm2 kill

   
   

3. Remove Current Node.js

   Check your operating system version
   

   head -1 /etc/os-release

   Choose the appropriate procedure for your system.
   Run following commands as root
   
   
   • Debian Linux - Node.js installed from repository(like the XorMon Appliance)
     

     apt remove nodejs

   • RHEL/Rocky Linux - Node.js installed from repository

     dnf remove nodejs

   • SUSE Linux - Node.js installed from repository

     zypper remove nodejs20

   • Node.js manually installed in /usr/local
     Delete files and directories used by Node.js
     

     rm /usr/local/bin/node /usr/local/bin/npm /usr/local/bin/npx /usr/local/bin/corepack /usr/local/share/man/man1/node.1
     rm -rf /usr/local/share/doc/node/ /usr/local/lib/node_modules/ /usr/local/include/node/

   
   

4. Install Node.js v24

   Choose the appropriate procedure for your system.
   Run following commands as root
   
   
   • Debian Linux with internet access (like the XorMon Appliance)
     

     curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
     apt install nodejs
     node -v

   • RHEL/Rocky Linux with internet access
     • Installing from appstream repository
       

       dnf module reset nodejs
       dnf module enable nodejs:24
       dnf install nodejs
       node -v

     • Installing from nodesource
       

       curl -fsSL https://rpm.nodesource.com/setup_24.x | bash -
       dnf install nodejs
       node -v

   • OpenSUSE Linux 15.6 with internet access Add devel:languages:nodejs repository
     

     zypper addrepo https://download.opensuse.org/repositories/devel:languages:nodejs/15.6/devel:languages:nodejs.repo
     zypper refresh
     zypper install nodejs24
     node -v

   • Linux without internet access
     Download and install latest v24 Node.js from prebuilt binaries on some other machine with the internet access.
     Download the latest version for your architecture from https://nodejs.org/dist/latest-v24.x
     The example below is from February 2026 for x86_64 Linux, for Linux on Power system use ppc64le
     

     cd /tmp
     wget https://nodejs.org/dist/latest-v24.x/node-v24.14.0-linux-x64.tar.xz

     Copy file node-v24.14.0-linux-x64.tar.xz to XorMon machine into /tmp/ dir and under root user:

     # extract archive to /usr/local
     cd /usr/local
     
     # do not foget about "--strip-components=1" parameter in below tar!
     tar xf /tmp/node-v24.14.0-linux-x64.tar.xz --strip-components=1
     
     # check node version, it should show v24
     /usr/local/bin/node -v
     
     # remove archive
     rm /tmp/node-v24.14.0-linux-x64.tar.xz
     
     # make sure xormon users sees v24 as well
     su - xormon
     node -v 

     Make sure that /usr/local/bin is in the PATH variable for user xormon.
     

     su - xormon
     echo $PATH
       /usr/local/bin:/usr/bin:/bin

     Add /usr/local/bin to PATH if necessary
     Edit .profile file for user xormon.
     

     su - xormon
     vi ~/.profile

     Add the following line at the end of the file
     

     export PATH=/usr/local/bin:$PATH

     Log out and log back in as xormon and check that the shell finds the node command without specifying the full path.
     

     su - xormon
     node -v

   
   

5. Enable port 443 for Node.js

   This is necessary if you want to use port 443 for the application front-end
   Note: this command must be run after every node.js upgrade.
   Run as root

   /usr/sbin/setcap 'cap_net_bind_service=+ep' $(readlink -f $(which node))
   
   # verify it
   /usr/sbin/getcap $(readlink -f $(which node))
     # Output should be:
     /usr/bin/node cap_net_bind_service=ep

   Some Linux distributions, such as SUSE, set command alternatives for multiple verions.
   In this case, set the port binding capability for the default alternative as well.
   
   
   • check for alternatives
     

         update-alternatives --get-selections | grep node
           node-default                   auto     /usr/bin/node24

   • set port binding capability
     

     /usr/sbin/setcap 'cap_net_bind_service=+ep' /usr/bin/node
     /usr/sbin/setcap 'cap_net_bind_service=+ep' /usr/bin/node24

   
   

6. Start XorMon

   Run following commands as xormon
   

       su - xormon
       cd ~/xormon-ng
       ./xormon.sh start

   In case XorMon does not start and hangs in 'Exiting verify.ts ....' server reboot is necessary, but it should not normally happen.
   
   

7. Upgrade to XorMon v2.2.0+

   You can continue with XorMon upgrade now.