GridGain Developers Hub
GitHub logo GridGain iso
GridGain Software Documentation

Running Client Nodes Behind NAT

If your client nodes are deployed behind a NAT, the server nodes won’t be able to establish connection with the clients because of the limitations of the communication protocol. This includes deployment cases when client nodes are running in virtual environments (like Kubernetes) and the server nodes are deployed elsewhere.

For cases like this, you need to enable a special mode of communication, which is defined by the IgniteConfiguration.environmentType = VIRTUALIZED property:

<bean class="org.apache.ignite.configuration.IgniteConfiguration">

    <property name="clientMode" value="true"/>

    <property name="environmentType" value="VIRTUALIZED"/>

    <!-- other properties -->
IgniteConfiguration cfg = new IgniteConfiguration();




  • EnvironmentType.VIRTUALIZED cannot be used when TcpCommunicationSpi.usePairedConnections = true on both server and client nodes.

  • Peer class loading for continuous queries (transformers and filters) will not work when a continuous query is started from a client node with IgniteConfiguration.environmentType = VIRTUALIZED. You will need to add the corresponding classes to the classpath of every server node.

  • This property can only be used on client nodes. This limitation will be addressed in the future releases.