Knowledge Base
Searching in : Article
ID: AR02U01187
Applies to: NX Licensing
Added on: 2023-02-06
Last Update: 2026-08-10

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:

The installed server type PE is not suitable for the subscription type S. Please
uninstall the server and install the appropriate product or contact NoMachine to
acquire a different subscription.
 
To solve:
 
1) Uninstall the free edition before installing the PE. Activate the Personal Edition using a NoMachine Personal Edition Subscription license or generate a 14-day evaluation license from your User Area. 
 
2) Uninstall the Personal Edition and re-install NoMachine free v9. This will continue to work as version 9 but it will be not possible to upgrade it to v10 or later.
 

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