If you encounter errors like NoMachine doesn’t connect or NoMachine connection refused, NoMachine directs you to its support team and Knowledge Base. The public NoMachine forum no longer accepts new posts, and support response times depend on your subscription: 48 hours for Personal Edition and 24 hours for Enterprise products, Monday to Friday. A support request typically involves the following steps:
- • Set debug log level manually
- • Reproduce the problem
- • Create compressed archives of logs
- • Send the archives to the NoMachine Support Team via e-mail
- • Request NM Support to provide a place to upload logs if file sizes exceed what can be sent as an e-mail attachment
This can take a while, but it makes much easier to define the most effective way to resolve the issue. To expedite a NoMachine not connecting solution (and more) before reaching out to IT support, check out a few of the following self-service methods provided in this article. We also suggest you read the NoMachine vs. RealVNC comparison article as well as the NoMachine vs. TeamViewer comparison.
NoMachine Connection Issues
Error 107: NoMachine Connection Refused
Along with the other issues (like NX NoMachine session failed or NoMachine no monitor), Error 107 most often means the client-side of the connection isn’t able to access NoMachine’s service (which is located on the remote host). Follow the steps below to try to correct this without involving NM support.
Method 1: Make sure the correct IP and Port are set correctly (Do this on NoMachine’s User Interface by opening Server Preferences > Services tab while operating the host that needs access permission).
Method 2: Ensure that firewall configurations on the server and client machines aren’t causing the problem (usually, firewalls aren’t the root issue if it’s native to the operating system being used).
Method 3: Review the nxserver status on the server machine (Do this by opening the Server Preferences (Server Preferences > Services tab) and ensuring status is set to ‘Running’).
“NoMachine Authentication Failed, Please Try Again” Error
Step 1: First, ensure the connection is reaching the intended machine (the one located at a workplace, for example).
Step 2: Examine the nxd.log file to check for any info regarding incoming connections (during the attempted connection) is the only way to accomplish this.
Step 3: If there’s no incoming connection, configure access to the appropriate machine via setting up a firewall or NAT router.
If NoMachine (server) computers are behind a firewall or NAT router, NoMachine can use the UPnP or NAT-PMP protocols (based on what the router supports) once automatic port mapping is enabled.
It does this to:
- • Retrieve the host’s public or external IP
- • Set up routers to permit NoMachine clients to connect from beyond the private network
All NoMachine server types support UPnP/NAT-PMP port mapping. Since version 8, it is disabled by default for every server type, so you need to turn it on in NoMachine or configure port forwarding on the router manually.
How it resolves potential issues:
UPnP or NAT-PMP port mapping services only function when:
- • It’s enabled within the server configuration
- • The router offers UPnP or NAT – PMP support
- • UPnP or NAT-PMP is enabled
- • The router accepts UPnP — or NAT-PMP commands to allow port forwarding
Regarding point 4 (“The router accepts UPnP or NAT-PMP commands to allow for enabling port forwarding”).
If the router won’t support UPnP or NAT-PMP commands, users must manually set it up via the administrative interface.
If you’d rather not configure the router, NoMachine recommends a separate NoMachine Network subscription for computers behind a NAT router. It requires NoMachine 9 or later on both machines. Otherwise, open port 4000 on the router and map it to the internal IP address of the NoMachine host.
The ports that must be opened and mapped on the host are:
• 4000 for connections using the NX protocol
• 22 for connections using the SSH protocol on Linux and macOS (4022 on Windows in version 8 and earlier)
• 4443 for web connections over HTTPS (Enterprise products only)
Step 1: From the system tray, click the “!M” icon to open the menu.
Step 2: Select ‘Show the service status’ (‘Connections’ or ‘ Server status’ via versions 5 and 4).
Step 3: Open ‘Server preferences’ (previously referred to as ‘Connection preferences’ on the free version of NoMachine versions 5 and 4).
Step 4: Open the Services panel.
Enabling UPnP/NAT-PMP port mapping
To enable automatic port mapping from the interface, open Settings > Server > Ports, select the NX service, click Configure, and check “Use UPnP to map the port” and “Start mode automatic”.
To enable it in the server configuration file (server.cfg) instead:
Step 1: Set EnableUPnP NXTCP,NXUDP for connections using the NX protocol
Step 2: Restart NoMachine
How to Configure Port Mapping via the UI on the Server Machine
Step 1: From the system tray, click the “!M” icon
Step 2: Select ‘Show the service status’
Step 3: Hit the ‘Restart the server’ button
The following values are available for the EnableUPnP key:
• EnableUPnP NXTCP,NXUDP: For connections using the NX protocol
• EnableUPnP SSH: For connections using the SSH protocol
• EnableUPnP HTTP: For web connections (Enterprise products only)
How to Disable UPnP/NAT-PMP Port Mapping:
Step 1: From the server configuration file (server.cfg) set: “EnableUPnP none”
Step 2: Restart NoMachine
Server connections are still possible — but only if server hosts (and end-user pc/devices) share the same local LAN — or if the server uses a public IP address.
Configuring NoMachine Settings and Network Access
How to Locate the “server.cfg” File
The configuration files for the server (server.cfg) are displayed below. For those using version 5 and under, if they have Cloud Server installed, their web players also provide a configuration file (“cloud.cfg.”)
From version 6 and on, web session keys are included in server.cfg—and the cloud.cfg file is gone.
Configuration files are kept in the ‘etc’ directory, under NoMachine’s installation directory:
/usr/NX/etc/server.cfg on Linux
InstallationDirectory/NoMachine/etc/server.cfg on Windows
(e.g. C:\Program files (x86)\NoMachine\etc\server.cfg)
/Applications/NoMachine.app/Contents/Frameworks/etc/server.cfg on Mac.
How to Open NoMachine ‘Server Preferences’
Users may need to access the GUI (Graphical User Interface) to manage the server and configure custom settings. There are two ways to accomplish this:
Method 1
- • Step 1: On the system tray, click the “!M” icon to open the menu
- • Step 2: Click Show the service status > Server preferences
Method 2
- • Step 1: Run NoMachine from your program menu
- • Step 2: Click Settings > Server preferences (a link located in the bottom panel)
NoMachine Audio & Display Problems
NoMachine No Audio Troubleshooting Solutions
Here is a selection of common audio/microphone issues that happen when running NoMachine physical desktops or virtual desktops/custom sessions via RHEL-based systems such as CentOS 7.
What to do if audio is missing in a NoMachine session:
-
Step 1: Download PulseAudio Volume Control.
-
Step 2: Run PulseAudio Volume Control.
-
Step 3: Navigate to “Output Devices”.
-
Step 4: Click the “Set as fallback” (a green button beside the built-in Audio Analog Stereo).
-
Step 5: Increase the sound level.
Missing audio—NoMachine audio devices are not available:
If there’s still no audio after using PulseAudio Volume Control to increase it, check whether NoMachine audio devices are actually available on the system.
Execute the following in a terminal:
pactl list sources | grep NoMachine
pactl list sources | grep nx
If the list is empty, users can recreate NoMachine sinks and sources by doing the following:
Step 1: End the PulseAudio process (this automatically creates a new process)
Execute in a terminal:
pulseaudio -k
Step 2: Restart the NoMachine server.
Execute in a terminal:
sudo /etc/NX/nxserver --restart
NoMachine Error: NoMachine Cannot Create a New Display/Negotiation Failed
If Linux users receive the following message when attempting to connect with a Linux host:
“The session negotiation failed. Error: Session failed, application terminated prematurely.”
… this can mean that programs/apps run by the NoMachine node (i.e. the desktop environment or a custom application) end immediately after initiating.
This can occur when the command that launches the desktop (or the custom app) is inaccurate.
The command that starts a Linux desktop environment is defined in the DefaultDesktopCommand key—within the node configuration file (“/usr/NX/etc/node.cfg.”)
For example: DefaultDesktopCommand “/etc/X11/Xsession ‘gnome-session –session=ubuntu’”
To check if the command is accurate, perform the following:
Step 1: Figure out which desktop environment is installed on a system by executing the following terminal command:
“ls /usr/share/xsessions”
Step 2: Retrieve the command to run the desired desktop. The command is shown in the *.desktop file in the line beginning with “Exec.”
For example:
grep ^Exec /usr/share/xsessions/gnome.desktop
returns:
Exec=gnome-session
Step 3: After retrieving the command, check that it’s set in the DefaultDesktopCommand key in node.cfge:
“DefaultDesktopCommand gnome-session”
Users don’t need to restart the server because the changes go into effect as soon as the new session starts.
Regarding custom sessions, the application running the node is specified within the UI of the client. For example: ‘Run the console‘ or the app set in ‘Run the following command‘.
When the program/software ends immediately, the following error gets reported inside the connection log file:
NX> 501 Session failed, application terminated prematurely
NX> 598 Error: failed to connect to nxclient –monitor.
On the end user’s host, the session log file reflects as follows:
3579 3579 15:18:18 658.862 ClientSession: Failing reason is ‘The session negotiation failed. Error: Session failed, application terminated prematurely.’
These error files are located in the NoMachine session directory, which is created in the /usr/NX/var/log/node directory.
When the error ‘application terminated prematurely‘ displays, it’s helpful to find possible causes in the below files (located on the remote host):
Number 1: The clients file within the: /usr/NX/var/log/node/C-<session> directory
For example:
“/usr/NX/var/log/node/C-testdrive2-1005-246612EE435B150D4A8D37463B948139/clients”
When a virtual desktop is running, however, consider that the X display manager commonly redirects the standard error to: “~/.xsession-errors” and NoMachine’s client file can be empty.
Number 2: The .xsession-errors file in the user’s home
For example: /home/nxtest01/.xsession-errors
Number 3: The system log
For example: /var/log/messages on Ubuntu
or, if the operating system is systemd-based: journalctl -b -0 > journalctl.txt
Number 4: The following test may also offer more information:
Step 1: Run a NoMachine custom session
Step 2: Choose ‘Run the console’ + ‘Run the command in a virtual desktop’
Step 3: Within this console, execute the same command set in the DefaultDesktopCommand key—within the node configuration file
NoMachine Cannot Change Resolution
Those using NoMachine Personal Edition (formerly the free edition) or Enterprise Desktop are connected to the remote computer’s physical desktop.
In this scenario, the maximum resolution available is the maximum resolution supported by the remote machine’s graphics card.
Display Resolution on Linux Remote Hosts
For those needing to run a higher resolution, and it’s a Linux remote host, think about utilizing products that support virtual desktop functionality, such as NoMachine Workstation.
The virtual desktop’s supported resolution won’t depend on the remote hardware, thus, the remote screen can be changed to whatever resolution is supported by the operator’s monitor.
Running with increased resolution is also possible via headless machines. In that circumstance, shut down the X server and allow NoMachine to create a virtual display.
NoMachine for Linux is intended to work out-of-the-box, regardless of the machine’s installed desktop environment. NoMachine can detect when X servers aren’t running, and so launch its own virtual display (an embedded X server.) This was enabled by default in the free edition (version 9 and earlier). In Enterprise Desktop, you can enable it by setting CreateDisplay 1 and DisplayOwner <username> in server.cfg.
NoMachine Black Screen Issue
What to Do if You See a Black Screen on Linux
This can happen when the X server is running but isn’t rendering due to the video card being turned off. In this scenario, NoMachine won’t use its own virtual display since it detects the X server running. There are a few possible solutions:
Use a Fake Display Dongle
Use a fake display dongle (also referred to as a ‘dummy dongle’) and insert it into the video card port to simulate the presence of a screen, thus forcing the system to take total advantage of the GPU as if a physical monitor was attached. For Linux hosts, rebooting the machine (or restarting the display manager) is required to make this work.
Setup Xorg for Working in Headless Mode
2.1) Configure X.org to run headless (use –allow-empty-initial-configuration)
2.2) Install a Xorg dummy driver by creating a fake EDID (Extended Display Identification Data) and use it in Xorg.conf (EDID are kept in the monitor, and read out by the GPU when a monitor is attached)
Use an X Virtual Framebuffer
Users can try any of the methods above (or manually stop the X server) to force NoMachine to use its own display service:
- • Use the proper command to stop the X server based on your display manager. For example:
sudo systemctl stop lightdm
or:sudo systemctl stop gdm
or:sudo systemctl stop sddmand so on …
or, if you aren’t sure what it is, try a “display-manager” alias:sudo systemctl stop display-manager
and restart the NoMachine server:sudo /etc/NX/nxserver --restart - • Now, NoMachine will create its own virtual framebuffer, and users should now have the ability to connect and view the desktop.
sudo init 3 Why HelpWire Is the Fix You’ve Been Looking for
HelpWire vs NoMachine: What You Get
| Feature | HelpWire | NoMachine Personal Edition |
| Initial setup time | ✅ In a few minutes | ⚠️ Port forwarding, firewall rules, or NAT setup for access outside the LAN |
| Access outside the local network | ✅ No client firewall changes | ⚠️ Port forwarding or a separate NoMachine Network subscription |
| Connection troubleshooting | ✅ Fewer steps to connect | ⚠️ Log collection and support tickets |
| Cross-platform support | ✅ Windows, macOS, Linux | ✅ Windows, macOS, Linux |
| Cost | ✅ Free plan with commercial use allowed | ⚠️ $24.50/year per computer, free trial available |
Closing Thoughts
We sincerely hope that this article has assuaged any apprehensions you may have had about Nomachine issues. Equipped with a thorough set of solutions, you are now more adept and prepared to handle these challenges with efficacy.
FAQ
This could be caused by a networking problem, a firewall, a NAT blocking incoming traffic, or because of an inaccurate server address.
The first thing to do is verify whether the CentOS server IP is accessible from the Windows client.
If the answer is yes, ssh to the server and check on NoMachine’s server status using sudo /etc/NX/nxserver --status.
If the server is off, try to restart the server with the command: sudo /etc/NX/nxserver --restart
If a doc file opened on the NoMachine server, and copy-paste (Ctrl+c and Ctrl+v) doesn’t work, check the /usr/NX/etc/server.cfg file to ensure the clipboard is enabled for both channels/directions. If not, use: EnableClipboard both
‘Error 108 connection reset by peer‘ occasionally happens when accessing the remote Linux physical desktop. This issue gets triggered because of an unexpected termination of the nxserver –daemon process.
A ‘connection refused’ error frequently happens when there aren’t any services listening on that port—or if a firewall connection is rejected. Users can find out if they can connect with another client via the same server.