NERSCPowering Scientific Discovery Since 1974


Make sure to check out the "Tutorial"


What Version of NX Player Will Work?

You need the latest NX Player (5.0.63 or later), please refer to the Tested Player Page for downloading instructions. 

My Font Size is TOO BIG/too small?

To change the font size inside your terminal (Konsole Application): In the menu of Konsole Application, choose "Settings"->"Manage Profiles", then click "Edit Profile...", now you can change the font size in the "Appearance" tab, after changing, click "OK" until you are back to the terminal. Now Every new terminal window you open will have the new font size. 

To change the font size of your menu bars/window titles: Right click on an empty desktop then choose "Konsole", inside the Konsole, type "kcmshell4 fonts". Then you have a dialog box to change your font size. 

How to Resize My Screen

With the latest NX Player (5.0.63 or later), the most effecient way is to enable "Remote Resize" in the NX menu. To do so:
1. Connect to NERSC NX, until you see your desktop;
2. Bring up the NX Player Menu with a Hotkey: 
Mac: Ctrl+Option+0, Windows: Ctrl+Alt+0, Linux: Ctrl+Alt+0
3. Choose "Display" submenu, then toggle the 2nd button until it shows "Remote Resize Enabled" 
Now you can freely resize your NX Player window and the remote desktop will resize accordingly.  

Emacs complains about missing fonts and shows white blocks?

This is due to a problem with font server. Please use the following command instead:

emacs -font 7x14

What Passwords are used in NX at NERSC?

Two passwords are related to the NERSC NX service:

1. Your NIM password. This is the password you will use to "LOGIN to NX", i.e. use it before you see the NX desktop. You can change this password at

2. Password for your NERSC NX Key pair (No.2 in the previous FAQ What Keys are used in NX at NERSC). You need to use this password when you click on the "NERSC Systems" menu INSIDE NX. To change this password, you need to choose "Regenerate Keypair" from the "SSH Agent" menu inside NX. 

How to Manually Kill a Frozen Session?

USE WITH CAUTION, this will kill one or more running sessions and all unsaved work will be lost. Your NX session may run on either of the following 2 servers, you need to login to both to kill all your leftover processes. 

1. Login to NX node


2. Use ps to get a list of runing nxnode or nxagent agents

ps -ef|grep $USER|grep nxagent
ps -ef|grep $USER|grep nxnode

3. use kill to kill all of nxagent and nxnode processes

The 2nd field from the output of the ps commands above is the PID, to kill a process use 

kill -9 PID 

4. Try to connect again

Can't Access NX?

Check that you can access the NX server


If you can't, log into to clear any login failures you might have. Once you do that, you should be able to connect via NX. If it still doesn't work, please open a ticket.

"Can't start CUPS server"?

Please upgrade to the latest NX Player (5.0.63 or later). 


Keypair, SSH Agent and NX

The NX server acts as a gateway to all other NERSC systems.  Users access other NERSC systems via SSH.  SSH Agent is used to help simplify the authentication from the NX server to other NERSC systems so that you do not need to type a password each time a new connection is created.  You can click on the "SSH Agent" menu to manage SSH Agent behaviors. 

Generating a Keypair

SSH Agent requires a keypair to function.  The first time you click an item on the "NERSC Systems" menu the keypair is created and installed.  You need to provide a password to encrypt your private key.  This password can be different from your NIM password.  You can regenerate the keypair by selecting the "(Re)generate Key Pair" menu item from the "SSH Agent" Menu.

Loading the Keypair

SSH Agent can load a keypair into memory and use it as the authentication method to other NERSC systems.  A keypair will be automatically loaded when a user tries to connect to a NERSC system via the menu.  After the keypair is loaded it will remain active until it is removed, i.e., the user can login to any NERSC system without entering a password each time.

SSH Agent Credential Removal Policy

For security reasons the NX Server will remove the loaded keypair from the SSH Agent on any of the following occasions (meaning you will need to type the keypair password again next time you connect to a NERSC System):

      • You suspend or terminate the current session;
      • You are inactive for 30-minutes;
      • 12 hours after the keypair is authenticated (12 hrs key lifetime).

Suspending or Terminating a NX Session

When you close the NX window (e.g., by clicking the "cross" button) a dialog box will appear providing the choice of either suspending or terminating the session.

      • Suspending the session will preserve most running applications inside the session intact and allow you to reconnect to the session at a later time.
      • Terminating the session will kill all the running applications inside the session and all unsaved work will be lost.

If you lose your connection to the NX server (e.g., if your internet connection is lost) NX will automatically suspend the session allowing you to reconnect to the same session while keeping the running applications intact.