2471
How to manually update the Node.js or MongoDB packages used by the Next-Generation License Server
In some situations, you may need to update the versions of MongoDB or Node.js that ship with and run the Next‑Generation License Server—whether for security patches or other operational needs. These components can be updated manually with minimal risk, provided you follow the version‑compatibility rules carefully.
Default component versions by License Server release
The table below lists the default MongoDB and Node.js versions included with each License Server release. These serve as your baseline for determining which versions you must stay aligned with when performing updates.
| License Server version |
Default MongoDB version |
Default Node.js version |
| 4.1 |
5.0.15 |
16.19.1 |
| 4.2.1 |
6.0.9 |
18.18.2 |
| 4.3 |
6.0.16 |
18.20.4 |
| 4.4 |
7.0.14 |
22.16.0 |
| 4.5 |
8.0.12 |
22.19.0 |
Warning: Alternative versions of MongoDB and Node.js have not been fully validated with the License Server. They may work if you follow the versioning rules below, but compatibility is not guaranteed. Proceed at your own discretion.
Updating MongoDB
- Identify which MongoDB version your installed License Server uses (see the table above). You must keep the same major AND minor version. Example: License Server 4.5 uses MongoDB 8.0.12 → you must stay within MongoDB 8.0.x.
- With that versioning in mind, MongoDB Community Edition can be downloaded here: https://www.mongodb.com/try/download/community. In addition to downloading the correct version for the correct platform, make sure also to get the "server" package version (this dropdown is only there for Linux).
- Before installing the updated MongoDB, stop the Next-Generation License Server service.
- Linux:
sudo INSTALL_DIR/node/bin/node INSTALL_DIR/service.js stop
- Windows: Open Windows Service panel, then right-click the NV5 Geospatial License Server service and select Stop.
- After installing the new MongoDB version, restart the Next-Generation License Server service.
- Linux:
sudo INSTALL_DIR/node/bin/node INSTALL_DIR/service.js start
- Windows: Open Windows Services panel, then right-click the NV5 Geospatial License Server service and select Start.
Updating Node.js
- Identify which Node.js version your License Server uses (see the table above). You must keep the same major version. Example: License Server 4.5 uses Node.js 22.19.0 → you must stay within Node 22.x.
- With that versioning in mind, Node.js can be downloaded here: https://nodejs.org/dist/. You can download a standalone installer or use a package manager.
- Before installing the updated Node.js package, stop the Next-Generation License Server service.
- Linux:
sudo INSTALL_DIR/node/bin/node INSTALL_DIR/service.js stop
- Windows: Open Windows Service panel, then right-click the NV5 Geospatial License Server service and select Stop.
- After installing the new Node.js version, restart the Next-Generation License Server service.
- Linux:
sudo INSTALL_DIR/node/bin/node INSTALL_DIR/service.js start
- Windows: Open Windows Services panel, then right-click the NV5 Geospatial License Server service and select Start.
Created by BC-US 6/10/2024 | Reviewed by TS 6/11/2024 | Updated by BC-US 1/4/2026