freenx Overview

NX is a technology for remote display. It provides near local speed application responsiveness over high latency, low bandwidth links. The core libraries for NX are provided by NoMachine under the GPL. FreeNX is a GPL implementation of the NX Server and NX Client Components.


To use FreeNX on OLCF systems, you will need the following software prerequisites:
  • The NX Client Software installed on your local machine. This is available from NoMachine.
  • An NX Key. This file allows the NX client to connect to the FreeNX server running on an OLCF resource.


Step 1: Download the NoMachine Player from The latest version of NoMachine is strongly recommended. The instructions below have been verified with version 5.3.9. Step 2: Install NoMachine player using the OS specific instructions provided on the download page Step 3: Rhea and Titan do not use the default key for NX, you will need to obtain the key for your local machine. For Rhea:
$ curl -o rhea.key
For Titan: Create a file called titan.key in your home directory on your local machine. Copy the text in the box below and paste it in your local titan.key file:
Step 4: Open the NoMachine player and click Continue Step 5: Click New in the orange bar. Step 6: Select SSH as the protocol. Step 7: Enter the host name and make sure the port is set to 22. Step 8: Select Use the NoMachine login. Step 9: Check Use an alternate server key an provide the path to rhea.key or titan.key. Step 10: Select whether or not you need to use an HTTP proxy. You may need to contact your network administrator for this information. Step 11: Give your connection a name. Step 12: Due to a compatibility issue with newer NoMachine clients and the NX servers on our systems, you'll need to edit the configuration you just created. Unfortunately, you can't do this via the client. Exit the client and find the configuration file. It should be named <Connection Name>.nxs where <Connection Name> is the name you selected in step 11). This file is usually located in the directory ~/.nx/config/ on Unix-like hosts. Open this file and find the line
 <option key="Connection service" value="ssh" />
On that line, change ssh from lowercase to uppercase so that it looks like:
 <option key="Connection service" value="SSH" />
Then, save the file and exit. Step 13: Restart NoMachine, click continue on the first screen, and, select your connection and click Connect. Step 14: Enter your username and SecurID PASSCODE. Step 15: Select the type of desktop you want. If you aren't sure, you can simply select GNOME. Step 16: Your session will now start. Step 17: You're now connected! You can suspend your session. Hit exit and chose Suspend. Take note of which login node you were connected to (in this case titan-ext6). Screenshot 2016-01-07 13.36.17 Step 18: You can now reconnect to that session. Create a new connection but this time, use the specific host you connected to previously ( following the same instructions above. After authenticating, hit [Back] button and you should see your suspended sessions. (this UI feature has been reported to NoMachine).   NoMachine reconnect to suspend

Note the number of the TCP connection matches the previous screenshot. (1037)

We recommend using the latest 5.X version of NoMachine Client.



  • default