NoMachine Support

Your questions answered

Knowledge Base

Searching in: Articles & FAQs
Filter the search results
Applies to:
Last update:
Searching in: Articles & FAQs
ID: AR09K00687
Applies to: NX Licensing
Added on: 2013-09-27
Last update: 2019-02-05
How to activate licenses for NoMachine 4 (or later)

With NoMachine v. 4 licenses can be activated only manually through the procedure described below. Such procedure can be used also for newer versions.

Starting from version 5, it's possible to activate licenses also from the NoMachine User Interface (GUI). See:

for v. 6 https://www.nomachine.com/AR11O00942

for v. 5 https://www.nomachine.com/AR07M00850



When you purchase a license for any of the NoMachine products, you will receive the license file(s) by email together with your customer ID and password.

Keep this log-in data safe to use them to access your own Customer Area: https://www.nomachine.com/support#login

From your Customer Area, download the NoMachine package to be installed in your production environment. You can also download your customer's license file(s).

Instructions below apply to server.lic and node.lic license types and must be executed on the host machine where you want to activate the license(s).

If you have installed a Terminal Server Node on Linux, you will have to activate only node.lic and you can skip steps related to 'server.lic'.

For AVC Pack customers: instructions for activating codec.lic are at the end of this article and must be executed on the client or the server machine where you want to use the NoMachine AVC pack.

 

Instructions

First upload the key.tar.gz archive containing your customer's license file(s) to that machine. Ensure to have administrative privileges to be able to activate a license.

On Linux and Mac the instructions below must be executed from a terminal and use the sudo utility. If you don't have sudo installed, run them without sudo and as root user.

On Windows, you must open a Command Prompt using the option to "Run as administrator".
You can open the Command Prompt via the Command Prompt shortcut located in the Start Menu or on the Apps screen on Windows 8. On Windows 10 you can also press Windows+X and click on 'Command Prompt (Admin)' in the Power Users menu. Otherwise you can open it by the cmd run command.

Index  
1. Activating server.lic and node.lic on Linux  
2. Activating server.lic and node.lic on Mac  
3. Activating server.lic and node.lic on Windows  
4. AVC Pack - Activating codec.lic on Linux  
5. AVC Pack - Activating codec.lic on Mac  
6. AVC Pack - Activating codec.lic on Windows  

1. Activating server.lic and node.lic on Linux

1)
First of all stop the server from accepting new connections during the operations necessary to activate the license files:
$ sudo /etc/NX/nxserver --stop

2)
Create a backup of the original license files:
$ sudo mv /usr/NX/etc/server.lic   /usr/NX/etc/server.lic-ori
$ sudo mv /usr/NX/etc/node.lic   /usr/NX/etc/node.lic-ori

3)
Extract the key.tar.gz archive you received by e-mail:
$ sudo tar xvzf key.tar.gz

4)
Copy the new license files server.lic and node.lic in the NoMachine etc directory:
$ sudo cp  server.lic  /usr/NX/etc
$ sudo cp  node.lic  /usr/NX/etc

5)
Move to the NoMachine etc directory, by default it's /usr/NX/etc:
$ cd /usr/NX/etc

6)
Set proper permissions:
$ sudo chmod 0400 server.lic
$ sudo chmod 0400 node.lic

and proper ownership:
$ sudo chown nx:root server.lic
$ sudo chown nx:root node.lic

7)
Verify if licenses are correctly activated:
$ sudo /etc/NX/nxserver --version
$ sudo /etc/NX/nxserver --subscription

$ sudo /etc/NX/nxnode --version
$ sudo /etc/NX/nxnode --subscription

8)
Finally, start the server:
$ sudo /etc/NX/nxserver --start
 

Troubleshooting:
Licenses are  'ASCII'  text  files in UNIX format. To make sure that files have not been accidentally converted to DOS format, run:

dos2unix /usr/NX/etc/node.lic
dos2unix /usr/NX/etc/server.lic

References: https://www.nomachine.com/AR07D00404


2. Activating server.lic and node.lic on Mac

1)
First of all stop the server to stop accepting new connections:
$ sudo /etc/NX/nxserver --stop

2)
Create a backup of the original license files:
$ sudo mv /Applications/NoMachine.app/Contents/Frameworks/etc/server.lic    /Applications/NoMachine.app/Contents/Frameworks/etc/server.lic-ori

$ sudo mv /Applications/NoMachine.app/Contents/Frameworks/etc/node.lic   /Applications/NoMachine.app/Contents/Frameworks/etc/node.lic-ori

3)
Extract the key.tar.gz archive:
$ sudo tar xvzf key.tar.gz

4)
Copy the license files server.lic and node.lic in the NoMachine etc directory:
$ sudo cp server.lic     /Applications/NoMachine.app/Contents/Frameworks/etc
$ sudo cp node.lic      /Applications/NoMachine.app/Contents/Frameworks/etc

5)
Then move to the NoMachine etc directory:
$ cd  /Applications/NoMachine.app/Contents/Frameworks/etc

6)
Set proper permissions:
$ sudo chmod 0400 server.lic
$ sudo chmod 0400 node.lic

Set proper ownership:
$ sudo chown nx:wheel server.lic
$ sudo chown nx:wheel node.lic

 

7)
Verify if licenses are correctly activated:
$ sudo /etc/NX/nxserver --version
$ sudo /etc/NX/nxserver --subscription

$ sudo /etc/NX/nxnode --version
$ sudo /etc/NX/nxnode  --subscription


8)
Finally, start the server:
$ sudo /etc/NX/nxserver --start

 


3. Activating server.lic and node.lic on Windows
First of all stop the server to stop accepting new connections. From the Command Prompt, move to the NoMachine bin directory and run the command to stop the server:

>cd %ProgramFiles(x86)%\NoMachine\bin
>nxserver --stop

Then move to the NoMachine etc directory and create a backup of the original license files:

>cd %ProgramFiles(x86)%\NoMachine\etc

>copy server.lic server.lic-ori
>copy node.lic node.lic-ori

Extract the key.tar.gz archive and copy the server and node license files to the NoMachine etc directory making sure they are renamed to server.lic and node.lic respectively. For example, browse to the installation folder of NoMachine: Computer -> C: > Program Files -> NoMachine -> etc. Now copy the server.lic and node.lic files to this folder.
 

Then in the Command Prompt, move to the NoMachine etc directory. Set proper ownership and permissions:

>cacls server.lic  /G nx:F Administrators:F
>cacls node.lic /G nx:F Administrators:F

IMPORTANT
If you are running a localized version of Windows, you must check whether the name of the Administrators group is localized in your language and run the command above with the proper translation.
 

Finally move to the NoMachine bin directory and start the server: >nxserver --star

To verify if licenses are correctly activated, run:

>nxserver --version
>nxserver --subscription

 


4. AVC Pack - Activating codec.lic on Linux
Download the key.tar.gz archive to your Linux. Extract the archive. Then copy the just extracted codec.lic file to /usr/NX/codec/etc and replace the default license coming with the package.
 

5. AVC Pack - Activating codec.lic on Mac
Download the key.tar.gz archive to your Mac. Extract the archive. Then copy the just extracted codec.lic file to /Library/Application Support/NoMachine/codec/etc and replace the default license coming with the package.
 

6. AVC Pack - Activating codec.lic on Windows
Download the key.tar.gz archive to your Windows PC. Extract the archive. Then copy the just extracted codec.lic file to the NoMachine codec etc directory in your %ProgramData% and replace the default license coming with the package.