NoMachine Support

Your questions answered

Knowledge Base

Searching in: Articles & FAQs
Filter the search results
Applies to:
Last update:
Searching in: Articles & FAQs
ID: AR02P00963
Applies to: NoMachine Software
Added on: 2018-02-02
Last update: 2021-02-19
How to start the session by passing options to the client from command line

To start a NoMachine connection, the NoMachine client reads the connection settings stored in the NXS files, which by default are in the user's Documents/NoMachine directory.

From the command line all you need to do is run the player and pass the session file with: 

<path to nxplayer> --session <session file >

By default, on Linux:

/usr/NX/bin/nxplayer --session <path to .nxs file>

on macOS:

/Applications/ --session <path to .nxs file>

on Windows:

it's possible to create a link to the nxplayer program and set the option to execute it in the property tab of such link.
Otherwise, to execute the client from a CMD console:

C:\Program files (x86)\NoMachine\bin\nxplayer --session <path to .nxs file>


If the connection file is pre-configured for running a custom session in floating-window mode, it's possible to specify the --hide option to hide the client window when connecting. The client window will appear again when the session disconnects. For example:

/usr/NX/bin/nxplayer --session <path to the NXS file> --hide


For more information on how to pre-configure the session file and other client settings, please consult: for v. 7 for v. 6 for v. 5