Knowledge Base
Searching in : Article
ID: AR07X01384
Applies to: NoMachine Server
Added on: 2026-07-28
Last Update: 2026-07-30

How to configure external address advertisement for Cluster slave redirection (v10)

Starting from NoMachine v9, the failover cluster (either made by two Enterprise Terminal Server Cluster or Enterprise Cloud Server Cluster) can use two Virtual IP addresses: one for the master role and one for the slave role. When load-balancing is enabled, a client connecting to the master Virtual IP can be redirected to the slave Virtual IP.
 
This can be problematic in NAT environments where the address reachable by external clients is different from the internal cluster Virtual IP configured on the server. In such setups, the master peer redirects the client to the internal
slave Virtual IP, which is not reachable from outside the customer network.
 
The following server commands, available since v10, let administrators specify the external host/IP address and ports that should be advertised to clients when a connection is load-balanced to the slave peer.
 
Commands:

nxserver --forward-slave-host <host>
Set the host or IP address advertised to clients when redirecting
connections to the slave virtual IP.
 
nxserver --forward-slave-nx-port <port>
Set the NX port advertised to clients when redirecting connections
to the slave virtual IP.
 
nxserver --forward-slave-ssh-port <port>
Set the SSH port advertised to clients when redirecting connections
to the slave virtual IP.