Project Setup and Required Modules

This page describes how to set up a Java project for GridGain 9, and which GridGain modules you should add as dependencies.

Prerequisites

GridGain is tested on Oracle JDK 11, 17, 21, and 25 (LTS), as well as JDK 26 (STS). Other Java vendors are supported, but may have minor discrepancies in performance or stability.

Short-term support (STS) Java versions are supported only until the next STS release, Long-term support (LTS) versions are not affected by this policy.

Adding the GridGain Repository

GridGain modules are published to the GridGain repository, not to Maven Central. Add the repository to your build before declaring any GridGain dependency.

<repositories>
    <repository>
        <id>GridGain External Repository</id>
        <url>https://www.gridgainsystems.com/nexus/content/repositories/external</url>
    </repository>
</repositories>

repositories {
    maven {
        url = "https://www.gridgainsystems.com/nexus/content/repositories/external"
    }
}

Adding the Client Dependency

The thin client provides the Table, Key-Value, SQL, Compute, Transactions, Catalog, and Data Streamer APIs used throughout the examples — the org.apache.ignite.* packages you see in the code samples. Add it as the single dependency for client applications:

<dependency>
    <groupId>org.gridgain</groupId>
    <artifactId>ignite-client</artifactId>
    <version>9.1.24</version>
</dependency>

implementation 'org.gridgain:ignite-client:9.1.24'

All GridGain modules share the org.gridgain group ID and the 9.1.24 version. Always declare the version that matches your cluster.

Required Modules

The following table lists the GridGain modules an application developer adds as dependencies. Add ignite-client for any thin-client application; add the other modules only when you use the corresponding feature or integration.

Artifact ID Add it when you use Reference

Artifact ID	Add it when you use	Reference
`ignite-client`	Table API, Key-Value API, SQL API, Compute, Transactions, Catalog, Data Streamer, Continuous Queries — any thin-client application.	Java Client
`ignite-jdbc`	The JDBC driver to connect over SQL.	JDBC Driver
`gridgain-jdbc-cache-store`	An external JDBC cache store.	Cache
`gridgain-map-structure`	Distributed map data structures (the `org.gridgain.structure` API), in addition to `ignite-client`.	Distributed Map
`gridgain-hibernate`	Hibernate ORM integration.	Hibernate
`spring-data-ignite`	Spring Data integration.	Spring Data
`spring-boot-starter-ignite-client`	Spring Boot autoconfiguration for the client.	Spring Boot

ignite-client

Table API, Key-Value API, SQL API, Compute, Transactions, Catalog, Data Streamer, Continuous Queries — any thin-client application.

Java Client

ignite-jdbc

The JDBC driver to connect over SQL.

JDBC Driver

gridgain-jdbc-cache-store

An external JDBC cache store.

Cache

gridgain-map-structure

Distributed map data structures (the org.gridgain.structure API), in addition to ignite-client.

Distributed Map

gridgain-hibernate

Hibernate ORM integration.

Hibernate

spring-data-ignite

Spring Data integration.

Spring Data

spring-boot-starter-ignite-client

Spring Boot autoconfiguration for the client.

Spring Boot

Next Steps

Use Java API — an end-to-end example using the modules above.
Java Client — full client configuration reference.
Table API — work with data once the client is connected.

© 2026 GridGain Systems, Inc. All Rights Reserved. Privacy Policy | Legal Notices. GridGain® is a registered trademark of GridGain Systems, Inc.
Apache, Apache Ignite, the Apache feather and the Apache Ignite logo are either registered trademarks or trademarks of The Apache Software Foundation.

Last updated on Jun 29, 2026