Command Line Parameters

General Parameters

-h [ --help ]

Print this help information.

--help-cfg

Print a template YAML configuration file to the console containing all available options and their default values as comments. Additional options in the current command line invocation are added as actual configuration options in the printed output.

-V [ --version ]

Print version information and exit.

-c [ --cfg-file ] arg

specify the path to the configuration file

--service

Run the Node process as a service (Windows only).

-v [ --verbose ]

Enables verbose logging.

--no-verbose

override option to 'false'

--environment arg

Specifies OS environment variable overrides. Individual overrides must be specified as key=value pairs, separated by spaces.

--reset arg

Reset the Node. Accepted values: ALL, SAF, RESTORE

Startup Parameters

--startup-init-listen-host arg

The hostname or IP address set on the HostnameOrIP property of a newly created Node object during initialization. "0.0.0.0" listens on all local interfaces. An empty string defaults to computer name.

--startup-init-listen-port arg (=6512)

The port set on the NodeListenerPort property of a newly created Node object during initialization. A zero value disables inter-Node communication.

--startup-init-json-file arg

Loads the JSON file at the specified path when the Node process is initialized for the first time.

--startup-lua-file arg

Executes the Lua script file at the specified path during process startup.

--startup-lua-chunk arg

Executes the Lua chunk provided as the option value during process startup.

--startup-exit

Terminate after startup operations (installation or command line script execution) instead of continuing to run the Node process.

--startup-no-exit

override option to 'false'

--startup-wait arg

Delay Node start-up for the specified amount of seconds.

System Parameters

--system-data-folder arg

The Node’s data folder for storing persistent data.

--system-mimalloc

Use the mimalloc memory allocator.

--system-disable arg

Disable specific system functionality or checks. Accepted values: PASSWORD_POLICIES, LUA

--system-security arg (=1)

Disable all access permission checks if set to 'false'.

Windows Services Parameters

-i [ --winsvc-install ]

Install and register the Node as a Windows service.

-r [ --winsvc-remove ]

Remove the Node from list of registered services.

-q [ --winsvc-query ]

Query the Node service status.

-n [ --winsvc-instance ] arg

Specifies the Node service instance name.

-s [ --winsvc-silent ]

Execute service operations silently (to be used with '--winsvc-install' or '--winsvc-remove' options only).

--winsvc-no-silent

override option to 'false'

-f [ --winsvc-firewall ]

Adjust Windows Firewall settings during service installation automatically (with '--winsvc-install' option only).

--winsvc-no-firewall

override option to 'false'

--winsvc-failure-actions-delay arg (=30)

Specifies the custom action delay (in seconds) after a service failure (default = 30).

--winsvc-failure-actions

Specifies if the service failure action configuration should be performed.

--winsvc-no-failure-actions

override option to 'false'

LMDB Parameters

--lmdb-sync-mode arg (=0)

Controls LMDB sync flags: 0 = full sync (default), 1 = MDB_NOMETASYNC (skip meta page flush), 2 = MDB_NOSYNC (skip all sync).

--lmdb-compact-on-startup

Compact the LMDB database file on startup. This reclaims space from deleted records by rewriting the file without free pages. Implies '--exit'.

--lmdb-no-compact-on-startup

override option to 'false'

--lmdb-max-readers arg (=1024)

Maximum number of simultaneous read-only transactions (LMDB reader slots). Corresponds to mdb_env_set_maxreaders(). Can only be increased from the previous value and not decreased. Default is 1024.

Restore Parameters

--restore-node-guid arg

The GUID of the Node being restored. The recovery connection objects should be created using startup scripts. Requires '--reset=RESTORE' to be specified.

--restore-connection-guid arg

The GUID of the passive UplinkConnection object owned by the Node being restored. The recovery connection objects should be created using startup scripts. Requires '--reset=RESTORE' to be specified.

Network Test Parameters

--network-test-start

Performs a network test to a remote machine.

--network-test-tls

Enables the TLS protocol in a network test.

--network-test-presharedkey arg

Custom pre-shared key when connecting to another Node process.

--network-test-msgsize arg

The message size to send for upload tests. In case of zero, the upload test will not be performed.

--network-test-remote-host arg (=localhost)

The remote host address used in a network test.

--network-test-remote-port arg (=6512)

The remote port used in a network test.