NoMachine Support

Your questions answered

Knowledge Base

Searching in: Feature Requests
Filter the search results
Target version:
Last update:
Searching in: Feature Requests
ID: FR03N03078
Added on:  2016-03-10
Last update: 2020-04-08
Priority: High
Products: NoMachine Server
Target: 6
Status:  Approved
Enabling the automatic recording at session startup

In the default configuration, the automatic recording of the session is disabled. Administrators can enable it via specific server commands for all users or only specific ones. In case of multinode environments, it will be possible to enable auto-recording everywhere or on the given node(s)only.

When auto-recording is enabled, a notification dialog will be issued to the user to accept or deny the recording of his/her session. A new server configuration key, AutomaticRecordingAuthorization, allows to tune this behavior.

Recorded files will be saved on the host where the session is running, by default in:
%PROGRAMDATA%/NoMachine/var/recording on Windows
/Library/Application Support/NoMachine/var/recording on macOS and
/usr/NX/var/recording on Linux.

The NXRecordingDirectory key in the node.cfg file will allow administrators to define a different directory where to save session recordings.

Node configuration key
# Specify the absolute path on the server where session recordings
# will be saved, by default %PROGRAMDATA%/NoMachine/var/recording
# on Windows, /Library/Application Support/NoMachine/var/recording
# on macOS and /usr/NX/var/recording/ on Linux.
#NXRecordingDirectory /usr/NX/var/recording

Server configuration key

# Enable, disable or restrict NX Server requesting authorization to
# connecting users to allow the automatic recording of the session.
# 0: Disabled. The user is informed that his/her session will be
#    recorded. If only a percentage of sessions is recorded,
#    the user is notified about that possibility.
# 1: Enabled. The user can accept or refuse to allow NoMachine
#    to record his/her session.
# 2: Restricted. The user can accept or refuse to allow NoMachine
#    to record his/her session but in this last case the session
#    will be terminated or disconnected in case of a virtual desktop.
#AutomaticRecordingAuthorization 1

Server commands:

--recording [yes|no] [--type physical|virtual]
                     [--percentage <% of sessions to be recorded>]
                     [--user <username>|--group <groupname>|--guest|
                      --node <node:port>|--nodegroup <groupname>]

Display current settings for the auto-recording feature, the same
if --status is provided. By default auto-recording is disabled at
session startup. Provide 'yes' to enable it for all users and all
type of sessions. In case of multi-host environments, it will be
enabled on all hosts. Specify 'no' to disable auto-recording. Give
--type to record only physical desktop sessions or virtual desktops
with at least one user connected. Provide --percentage to specify
the percentage of sessions to be recorded. Set the auto-recording
on a per-user or on a per-group of users basis by using --user and
--group respectively. Provide --guest to record only sessions run
by guest users. For multinode environments, to set auto-recording
on per-node basis, use the --node or the --nodegroup option.

--recordinglist  [--clear all|<filename>]

List the session recordings already finished. Use --clear to delete
all of them or specify a single recording file to be deleted.

--recordingdel [--user <username>|--guest| --group <groupname>|
                --node <node:port>|--nodegroup <groupname>]
Remove all settings for auto-recording feature and delete already
finished recordings. Provide any of the available options to reset
settings for a specific user(s) or node(s).

Notify me when the FR is implemented.