Chapter 1. Remote caches

Deploy multiple Data Grid Server instances to create remote cache clusters that give you a fault-tolerant and scalable data tier with high-speed access from Hot Rod and REST clients.

1.1. Remote cache tutorials

To run these tutorials you need at least one locally running instance of Data Grid Server.

You can download the distribution and run the following commands:

$ ./bin/ user create admin -p "password"
$ ./bin/

Data Grid Server enables authentication and authorization by default. Creating a user named admin gives you administrative access to Infinispan Server.

Building and running remote cache tutorials

You can build and run remote cache tutorials directly in your IDE or from the command line as follows:

$ mvn -s /path/to/maven-settings.xml clean package exec:exec

1.2. Hot Rod Java client tutorials

  • Hot Rod Java clients require JDK 8 or later. However, Data Grid recommends using Java 11 at a minimum.
Tutorial linkDescription

Remote cache use example

The simplest code example that demonstrates how a remote distributed cache works.

Per cache configuration

Demonstrates how to configure caches dynamically when we connect to the Data Grid Server.

Near caches

Demonstrates how configure near caching to improve the read performance in remote caches.

Cache Admin API

Demonstrates how to use the Administration API to create caches and cache templates dynamically.


Demonstrates how encoding of caches work.

Client listeners

Detect when data changes in a remote cache with Client Listeners.


Demonstrates how to query remote cache values.

Continuous query

Demonstrates how to use Continuous Query and remote caches.


Demonstrates how remote transactions work.

Secured caches

Demonstrates how to configure caches that have authorization enabled.

TLS authorization

Demonstrates how to connect to Data Grid Server with TLS authorization.


Demonstrates how remote counters work.


Demonstrates how remote multimap works.

Task execution

Demonstrates how to register server tasks and how to execute them from the Hot Rod client.

JUnit 5 and Testcontainers

Demonstrates how to use the Data Grid and JUnit 5 extension.


Demonstrates how to use the Data Grid and persistent caches.

Data Grid documentation

You can find more resources for Hot Rod Java clients in our documentation at: