Connecting to Your Cluster

You can connect to your cluster by using the following clients:

Java Thin Client
.NET Thin Client
[.NET LINQ Thin Client]
[C++ Thin Client]

Connection URI and API credentials

All examples below contain the {connectionUri}, {login} and {password} values. You can get {connectionUri} from in Connections widget and {login} and {password} from My cluster tab.

Java Thin Client

Java thin client is a lightweight client that connects to the cluster via a standard socket connection. It does not become a part of the cluster topology, never holds any data, and is not used as a destination for compute calculations. The thin client simply establishes a socket connection to a standard node and performs all operations through that node.

Add the following dependencies to your Maven project:

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

<dependencies>
    <dependency>
        <groupId>org.gridgain</groupId>
        <artifactId>ignite-core</artifactId>
        <version>${gg.version}</version>
    </dependency>
</dependencies>

Create a client configuration and replace the {login} and {password} placeholders with your cluster credentials.

    public static void main(String[] args) {
        SslConfiguration sslConfiguration = new SslConfigurationBuilder()
                .enabled(true)
                .build();
        IgniteClientAuthenticator auth = BasicAuthenticator.builder()
                .username("{login}")
                .password("{password}")
                .build();
// Connect to the cluster.
        try (IgniteClient client = IgniteClient.builder()
                .addresses("{connectionUri}:10800")
                .authenticator(auth)
                .ssl(sslConfiguration)
                .build()) {
// Query the table using SQL.
            client.sql().execute(null, "CREATE TABLE IF NOT EXISTS Person (id VARCHAR PRIMARY KEY, name VARCHAR)");

        }
    }

For more information on thin clients, please see this article.

.NET Thin Client

Prerequisites:

Supported runtimes: .NET 8.0+
1. Install .NET SDK
2. Copy Program and dependency example files to an empty folder.
3. Replace the {gg.version} parameter that should match the version of the managed cluster.
4. Replace the {login} and {password} placeholders with your cluster API credentials.
5. Execute dotnet run in that folder.

For more information on .NET Thin Client, please see this article.

.NET LINQ Client

Prerequisites:

Supported runtimes: .NET 8.0+
1. Install .NET SDK
2. Copy Program and dependency example files to an empty folder.
3. Replace the {gg.version} parameter that should match the version of the managed cluster.
4. Replace the {login} and {password} placeholders with your cluster API credentials.
5. Execute dotnet run in that folder.

For more information on .NET LINQ Client, please see this article.

© 2025 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 Aug 04, 2025