Table of Contents

Welcome to the NoMachine Server Installation Guide for the Enterprise version 5 or higher. This guide applies to the following products from the NoMachine for the Enterprise range: Workstation, Small Business Server, Terminal Server, Enterprise Desktop and Enterprise Server. This document is intended to provide you with step-by-step instructions on how to install, update or remove the NoMachine software on/from your system.

For the sake of simplicity, the software you install will be referred to as NoMachine Server.

Once installation has been completed with success, NoMachine Server is up-and-running and ready to accept connections. You can check or change current settings and manage server side services from the Server preferences panel in the NoMachine GUI. From the same GUI you can also initiate a connection to another computer (i.e all NoMachine Servers provide a connection GUI).

To access the Server preferences panel:

click on the !M icon in the system tray and choose 'Show the server status'

or access it from the the NoMachine GUI. Click on 'Settings' and on the 'Server preferences' link at the bottom of the Settings panel.

The NoMachine Web site, www.nomachine.com, provides you with a variety of online resources in conjunction with the software and its usage:

The NoMachine Packages
The latest version of NoMachine is available at: www.nomachine.com/download

The Knowledge Base
The Knowledge Base, https://www.nomachine.com/support, makes available both technical documents especially for administrators and end-user oriented guides, as well as articles on specific topics and How-Tos.

Leave Feedback About This Guide
Our goal is provide comprehensive and clear documentation for all the NoMachine products. If you would like to send us your comments and suggestions, you can use the Web contact tool available at https://www.nomachine.com/contact-request, by selecting the Web Quality Feedback as your option.

Operating Systems

Windows 32-bit/64-bit XP/Vista/7/8/8.1/10
Mac Intel 64-bit OS X 10.5/10.6/10.7/10.8/10.9/10.10/10.11, macOS 10.12
Linux 32-bit and 64-bit

• Red Hat Enterprise 4/5/6/7
• SLED 10.x/11.x
• SLES 10/11/12
• Open SUSE 10.x /11.x/12.x/13.x
• Mandriva 2009/2010/2011
• Fedora Core 10/11/12/13/14/15/16/17/18/19/20/21/22/23
• Debian GNU Linux 4.0 Etch/5.0 Lenny/ 6.0 Squeeze/7.0 Wheezy/8.0 Jessie
• Ubuntu 8.04 Hardy Heron/8.10 Intrepid Ibex/Ubuntu 9.04 Jaunty Jackalope/
  9.10 Karmic Koala/10.4 Lucid Lynx/10.10 Maverick/11.04 Natty/11.10 Oneiric/
  12.04 Precise Pangolin/12.10 Quantal Quetzal/13.04 Raring Ringtail/
  13.10 Saucy Salamander/14.04 Trusty Tahr/14.10 Utopic Unicorn/15.04 Vivid Vervet/
  15.10 Wily Werewolf/16.04 Xenial Xerus

Hardware requirements

The software is designed to work on computers with minimal HW requirements. Although the software may work with inferior CPUs or reduced RAM, for best performance NoMachine recommends you match the listed requirements.

- Intel Core2 Duo or AMD Athlon Dual-Core or equivalent

- 1 GB RAM

- Network connection (either a LAN, or Internet link: broadband, cable, DSL, etc...)

Size required on disk:

Windows 96.5 MB
Linux 74 MB
Mac 79 MB

Connecting from client 3.5.0 or by using a 3.5.0 connection file to a server 5 from the Terminal Server or Enterprise family

Provided you don't have SSH support disabled on the server, you should be able to connect from client 3.5.0 with no further intervention.

Connecting from client 5 to NX server 3.5.0

Edit the connection settings in the client GUI and choose to use the protocol SSH, then select 'NoMachine login' from the Advanced panel settings.

Download the package from the NoMachine web site and install it by double-clicking on the icon of the executable: a setup wizard will take you through the installation. Accept to reboot the machine, this is mandatory for completing the installation.

IMPORTANT
If you own a customer license we recommend to download and install the package marked for PRODUCTION from your Customer Area: https://www.nomachine.com/support#login.

Tip

To install the package in silent or very silent mode from a CMD console, run respectively :

>nomachine-packageName_packageVersion.exe /silent

or:

>nomachine-packageName_packageVersion.exe /verysilent

Then reboot the machine:

> SHUTDOWN -r -t 10 -c " your comments here"

To specify a non-default installation directory, use:

nomachine-packageName_packageVersion.exe /SILENT /DIR="X:Target_directory"

or:

nomachine-packageName_packageVersion.exe /VERYSILENT /DIR="X:Target_directory"

Note for Windows XP: the NoMachine server will not start until the machine is rebooted.

You can update your installation from our repositories instead of downloading and installing the new package. Just run the NoMachine GUI from your Programs Menu and access the Updates panel.

Run the NoMachine GUI, access the 'Settings' panel and click on 'Server preferences'. Go to the 'Updates' GUI and click on the 'Check now' button.

Note that since version 4.6.3 NoMachine has the automatic check for updates enabled: it will periodically check our repositories (by default every two days) to verify if updates are available. In this case, the server will prompt a dialog informing that a new version is available but it will never automatically update the current installation.

Checking for updates can be disabled from that dialog by selecting the 'Don't ask again for this version' option or in the Updates panel by unchecking the 'Automatically check for updates' option.

Alternatively, you may download the latest available package from the NoMachine web site and click on the executable file to launch Setup. As for the installation, Setup will guide you through all steps necessary for updating your installation.

IMPORTANT
- If you own a customer license we recommend to download and install the package marked for UPDATE from your Customer Area:
https://www.nomachine.com/support#login.

- The update procedure for server and node installations requires to stop all NoMachine services in order to correctly replace libraries and binaries. This implies that all running sessions are terminated during the update procedure and cannot be recovered later. This applies to upates made by using NoMachine packages and to automatic updates from NoMachine repositories.

You can uninstall NoMachine from the Windows Control Panel and the Add or Remove Programs in Windows XP or Program and Features in Windows Vista, 7 or 8. Find the NoMachine program in the list of installed programs and choose to uninstall it.

On Windows 8, you can use the Search box from the Charms bar on the right side of the screen: type there Control Panel to open it. Then access the Programs - 'Uninstall a program' panel.

On Windows 7, Vista and XP, click on the Start button and click to open the Control panel from the Start menu. Then access panel 'Programs and Features' or 'Add or Remove Programs', depending on your Windows version.

Reboot is requested to complete the uninstalling process.

Tip

To uninstall from a CMD console, move to C:/ProgramData/NoMachine/var/uninstall/ (if you are on Vista/7/8) or to C:/Documents and Settings/All Users/NoMachine/var/uninstall/ (if you are on XP). Then run:

> unins000.exe /silent

or:

> unins000.exe /verysilent

Uninstalling is completed when your command prompt is back. Then, your computer will restart automatically.

Download the DMG package from the NoMachine web site. Double-click on the disk Image to open it and see the package icon. Then double-click on the package icon to install the program: the installer will take you through the installation.

IMPORTANT
If you own a customer license we recommend to download and install the package marked for PRODUCTION from your Customer Area: https://www.nomachine.com/support#login.

Tip

To install from the command line, run:

$ NXMOUNTDIR=$(echo `hdiutil mount nomachine-packagename_version.dmg | tail -1 | awk '{$1=$2=""; print $0}'` | xargs -0 echo)

$ sudo installer -pkg "${NXMOUNTDIR}/NoMachine.pkg" -target /

You can update your installation from our repositories instead of downloading and installing the new package. Just run the NoMachine GUI from your Applications and access the Updates panel.

Run the NoMachine GUI, access the 'Settings' panel and click on 'Server preferences'. Go to the 'Updates' GUI and click on the 'Check now' button.

Note that since version 4.6.3 NoMachine has the automatic check for updates enabled: it will periodically check our repositories (by default every two days) to verify if updates are available. In this case, the server will prompt a dialog informing that a new version is available but it will never automatically update the current installation.

Checking for updates can be disabled from that dialog by selecting the 'Don't ask again for this version' option or in the Updates panel by unchecking the 'Automatically check for updates' option.

Alternatively, you may download the latest available package from the NoMachine web site and click on the dmg file to mount the disk image. Then click on the package icon to initiate the update. As for the installation, Installer will guide you through all steps necessary for updating NoMachine.

IMPORTANT
- If you own a customer license we recommend to download and install the package marked for UPDATE from your Customer Area: https://www.nomachine.com/support#login.

- The update procedure for server and node installations requires to stop all NoMachine services in order to correctly replace libraries and binaries. This implies that all running sessions are terminated during the update procedure and cannot be recovered later. This applies to upates made by using NoMachine packages and to automatic updates from NoMachine repositories.

To uninstall, just drag and drop NoMachine from Applications to trash or select 'Move to trash' from the mouse button menu. Administrative credentials are requested.

Tip

To uninstall from command line, it's enough you remove the NoMachine application directory:

$ sudo rm -rf /Applications/NoMachine.app

Notes for the first installation

You can either choose to install NoMachine by using the graphical installation program provided with your Linux distribution, or do it from the command line. If you choose to use the graphical installation, depending on which Linux distribution you are using, download the DEB or the RPM package from the NoMachine web site and double click on the package icon to install it via your installation program.

IMPORTANT
If you own a customer license we recommend to download and install the package marked for PRODUCTION from your Customer Area: https://www.nomachine.com/support#login.

If you already run an installation for evaluation please follow instructions here: https://www.nomachine.com/AR02M00837

For installation from command line refers to instructions below. They must be run as root user or by using the sudo utility.

Notes for updating the installation

You can update your installation from our repositories instead of downloading and installing the new package. Just run the NoMachine GUI from your Programs Menu and access the Updates panel.

Run the NoMachine GUI, access the 'Settings' panel and click on 'Server preferences'. Go to the 'Updates' GUI and click on the 'Check now' button.

Note that since version 4.6.3 NoMachine has the automatic check for updates enabled: it will periodically check our repositories (by default every two days) to verify if updates are available. In this case, the server will prompt a dialog informing that a new version is available but it will never automatically update the current installation.

Checking for updates can be disabled from that dialog by selecting the 'Don't ask again for this version' option or in the Updates panel by unchecking the 'Automatically check for updates' option.

Alternatively, you may download the latest available package from the NoMachine web site and use the graphical installation program provided with your Linux distribution or update the installation by command line as explained below.

IMPORTANT
- If you own a customer license we recommend to download and install the package marked for UPDATE from your Customer Area: https://www.nomachine.com/support#login.

- The update procedure for server and node installations requires to stop all NoMachine services in order to correctly replace libraries and binaries. This implies that all running sessions are terminated during the update procedure and cannot be recovered later. This applies to upates made by using NoMachine packages and to automatic updates from NoMachine repositories.

If you want to install to default location, namely /usr/NX

Installing
# rpm -ivh <pkgName>_<pkgVersion>_<arch>.rpm

Updating
# rpm -Uvh <pkgName>_<pkgVersion>_<arch>.rpm

Uninstalling
# rpm -e nomachine

If you want to install to a non-default location, for example /opt/NX

Installing
# rpm -ivh <pkgName>_<pkgVersion>_<arch>.rpm --prefix /opt

Updating
# rpm -Uvh <pkgName>_<pkgVersion>_<arch>.rpm --prefix /opt

Uninstalling

# rpm -e <pkgName>

where <pkgName> is any of the available NoMachine server package types:

nomachine-cloud-server
nomachine-enterprise-desktop
nomachine-enterprise-server
nomachine-small-business-server
nomachine-terminal-server
nomachine-workstation

or even:

nomachine-enterprise-client
nomachine-terminal-server-node

Tip

To find out which NoMachine package you have installed, run the following command:

# rpm -qa | grep nomachine

You will get the full name of the NoMachine package already installed, for example: nomachine-enterprise-server-4.4.10-1.x86_64.

If you want to install to a non-default location, for example /opt/NX

Installing

# rpm -ivh <pkgName>_<pkgVersion>_<arch>.rpm --prefix /opt

Updating

# rpm -Uvh <pkgName>_<pkgVersion>_<arch>.rpm --prefix /opt

Uninstalling

# rpm -e <pkgName>

If you want to install to default location, namely /usr/NX

Installing
$ sudo dpkg -i <pkgName>_<pkgVersion>_<arch>.deb

Updating
$ sudo dpkg -i <pkgName>_<pkgVersion>_<arch>.deb

Uninstalling
$ sudo dpkg -r <pkgName>

where <pkgName> is any of the available NoMachine server package types:

nomachine-cloud-server
nomachine-enterprise-desktop
nomachine-enterprise-server
nomachine-small-business-server
nomachine-terminal-server
nomachine-workstation

or even:

nomachine-enterprise-client
nomachine-terminal-server-node

Tip

To find out which NoMachine package you have installed, run the following command:

$ dpkg -l | grep nomachine

You will get the full name of the NoMachine package already installed, for example: nomachine-enterprise-server 4.4.10-1.

If you want to install to a non-default location, for example /opt/NX

Installing
$ sudo NX_INSTALL_PREFIX=/opt dpkg -i <pkgName>_<pkgVersion>_<arch>.deb

Updating
$ sudo NX_INSTALL_PREFIX=/opt dpkg -i <pkgName>_<pkgVersion>_<arch>.deb

Uninstalling
$ sudo dpkg -r <pkgName>

If you want to install to the default location /usr/NX ensure that package is placed there.

Installing
$ cd /usr
$ sudo tar xvzf <pkgName>_<pkgVersion>_<arch>.tar.gz
$ sudo /usr/NX/nxserver --install

Updating
$ cd /usr
$ sudo tar xvzf <pkgName>_<pkgVersion>_<arch>.tar.gz
$ sudo /usr/NX/nxserver --update

Uninstalling
$ sudo /usr/NX/scripts/setup/nxserver --uninstall
then, remove the installation dir:
$ sudo rm -rf /usr/NX

If you want to install to a non-default location, for example /opt/NX, extract the archive in /usr/NX and then use the following commands:

Installing
$ sudo NX_INSTALL_PREFIX=/opt /usr/NX/nxserver --install

Updating
$ sudo NX_INSTALL_PREFIX=/opt dpkg -i /usr/NX/nxserver --update

Uninstalling
$ sudo /opt/NX/scripts/setup/nxserver --uninstall
then remove the installation dir:
$ sudo rm -rf /opt/NX

Once you have terminated the installation or the update, including reboot when requested, a NoMachine icon (!M) will appear in your system tray. This is the Monitor, a small application which gives you fast access to server management tools and advises you when someone is requesting to connect to your desktop. If a user is connected, you can disconnect them from the Monitor.

From a client PC, where you have already installed a NoMachine package type or the Enterprise Client, run the NoMachine GUI from the programs or applications menu. A wizard will take you through the steps necessary to set-up your first connection, just click on 'Create a new connection'. If you prefer to skip the wizard, click on 'Continue'.

The fastest way to create a new connection is to write the name or IP of the NoMachine host you want to connect to in the text field and click on the 'Press enter to create a new connection' link. This method will use the default NX protocol on port 4000.

Alternatively, you can click on the 'New' icon next to the white text field to configure the session in more detail.

Note that IPv6 is supported since version 4.1. Specify the IP address of the server host in IPv6 format (e.g. 2001:0:5ef5:79fb:30c6:1516:3ca1:5695) if you want to use it instead of IPv4.

For more details on how to connect to a NoMachine host and configure the NoMachine Server for your environment, please consult the appropriate guide from the documents section: https://www.nomachine.com/support and https://www.nomachine.com/documents.