NoMachine license compatibility guide: Matching products, licenses and versions
NoMachine licenses are product-specific. You must install the server package that corresponds to the license you own. For example, if you have a license for NoMachine Workstation, the software you install must be a NoMachine Workstation package, or if you have a Personal Edition installed, it can only be activated with a Personal Edition license etc. It is not possible to use your subscription license in a product of a different name. The installation procedure will be blocked with a message similar to:
Two different NoMachine packages can't be installed at the same time on the same host. Be sure you uninstall [product name] before installing a different NoMachine products.
Or in the logs, you might see:
NX> 630 ERROR: The installed server type CS is not suitable for the subscription type EDSS.
NX> 630 ERROR: Please uninstall the server and install the appropriate product or
NX> 630 ERROR: contact NoMachine to acquire a different subscription.
To solve it, uninstall the current package, install the package that fits your license and install the license.
Some remarks
1) On Linux, you can check which package is installed in the following way.
RPM:
rpm -qa | grep nomachine
DEB:
dpkg -l | grep nomachine
2) With version 9, we introduced online license validation. All product editions from v9 onwards are validated using the NoMachine licensing server. On-premise licenses are still available for those customers with air-gapped networks.To find out how this works in detail, see: https://kb.nomachine.com/AR10U01206
3) Compatibility between server version and license version:
| Subscription Version | v8 Server | v9 Server | v10 Server |
| v10 Subscription (online) | No | No | OK |
| v10 Subscription (on-prem) | No | No | OK |
| v9 Subscription (online) | No | OK | OK |
| v9 Subscription (on-prem) | No | OK | OK |
| v8 Subscription | OK | OK | OK |
4) The new major version 10 introduces a new product, the Personal Edition (with acronym PE), while the free version of the server (with acronym S) has been discontinued. It is not possible to upgrade a free server installation, or any other server installed, with the Personal Edition because they are different products (as outlined in point 1). Uninstall the product you want to replace, then install the Personal Edition.
Known Issue on macOS
In NoMachine v10.0.57, package validation on macOS may not properly prevent this upgrade scenario. As a result, users who upgrade from the free version to v10 may encounter an error such as:
For older NoMachine versions
Updating Workstation or Small Business Server installations from v7 to v8 is an out-of-the-box process. There are some exceptions which require a new license and these are detailed here: https://kb.nomachine.com/AR12S01147
What you should do is:
1) Verify that the installed server software matches the license you own. If not, uninstall it and install the appropriate package.
To check which NoMachine RPM package is installed:
rpm -qa | grep nomachine
To check which NoMachine DEB package is installed:
dpkg -l | grep nomachine
2) Upgrade server installation v7 to v8
Installing version 8 from scratch will be necessary if you're using two v7 servers in failover cluster or if you want to adopt any of the new cloud server products (see https://kb.nomachine.com/AR12S01147). In those cases obtaining a new v8 license key is also required. Please contact sales to request new licenses.
For all other products in the Enterprise suite, you can continue to use your license v7 in a v8 installation, just be sure to have the appropriate package installed. To make it easier to find which server package to install, you can download it from your Customer Area (https://www.nomachine.com/customer-details) where only that server type matching your license is listed.
Some related articles:
How to upgrade from Enterprise Terminal Server v7 with failover cluster to Enterprise Terminal Server Cluster v8
https://kb.nomachine.com/AR11T01180
How to migrate NoMachine 7 configurations to a new machine
https://kb.nomachine.com/AR02T01153
