Node.js upgrade to v24


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
  • Reboot (optional)
  • 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. Reboot (optional)

    Sometimes appears that the Xormon machine must be rebooted after Node.js upgrade.
    Go for that in case there is any problem with XorMon runtime or upgrade.

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

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

  8. Upgrade to XorMon v2.2.0+

    You can continue with XorMon upgrade now.