Need help with hazelcast-go-client?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

152 Stars 43 Forks Apache License 2.0 703 Commits 61 Opened issues


Hazelcast IMDG Go Client

Services available


Need anything else?

Contributors list

Hazelcast Go Client

Hazelcast is an open-source distributed in-memory data store and computation platform that provides a wide variety of distributed data structures and concurrency primitives.

Hazelcast Go client is a way to communicate to Hazelcast 4 and 5 clusters and access the cluster data.

Sample Code

package main

import ( "context" "fmt" "log"



func main() { ctx := context.TODO() // create the client and connect to the cluster client, err := hazelcast.StartNewClient(ctx) if err != nil { log.Fatal(err) } // get a map people, err := client.GetMap(ctx, "people") if err != nil { log.Fatal(err) } personName := "Jane Doe" // set a value in the map if err = people.Set(ctx, personName, 30); err != nil { log.Fatal(err) } // get a value from the map age, err := people.Get(ctx, personName) if err != nil { log.Fatal(err) } fmt.Printf("%s is %d years old.\n", personName, age) // stop the client to release resources client.Shutdown(ctx) }


  • Distributed, partitioned and queryable in-memory key-value store implementation, called Map.
  • Additional data structures and simple messaging constructs such as Replicated Map, Queue, List, PNCounter, Set, Topic and others.
  • Support for serverless and traditional web service architectures with Unisocket and Smart operation modes.
  • Go context support for all distributed data structures.
  • Hazelcast Cloud integration.
  • External smart client discovery.
  • Hazelcast Management Center integration.
  • Ability to listen to client lifecycle, cluster state, and distributed data structure events.
  • And more...



  • Hazelcast Go client is compatible only with Hazelcast IMDG 4.x and above.
  • We support Go 1.15 and up.

In your Go module enabled project, add a dependency to
: ```shell

Depend on a specific release

$ go get[email protected] ```

Quick Start

Hazelcast Go client requires a working Hazelcast IMDG cluster. This cluster handles the storage and manipulation of the user data.

A Hazelcast IMDG cluster consists of one or more cluster members. These members generally run on multiple virtual or physical machines and are connected to each other via the network. Any data put on the cluster is partitioned to multiple members transparent to the user. It is therefore very easy to scale the system by adding new members as the data grows. Hazelcast IMDG cluster also offers resilience. Should any hardware or software problem causes a crash to any member, the data on that member is recovered from backups and the cluster continues to operate without any downtime.

The quickest way to start a single member cluster for development purposes is to use our Docker images.

docker run --rm --name hazelcast -p 5701:5701 hazelcast/hazelcast:4.2

You can also use our ZIP or TAR distributions. After the download, you can start the Hazelcast member using the bin/ script.

Starting the Default Client

Start the client with the default Hazelcast IMDG host and port using

ctx := context.TODO()
client, err := hazelcast.StartNewClient(ctx)
// handle client start error

Starting the Client with Given Options

Note that

structs are not thread-safe. Complete creation of the configuration in a single goroutine.
// create the default configuration
config := hazelcast.Config{}

// optionally set member addresses manually config.Cluster.Network.SetAddresses("", "")

// create and start the client with the configuration provider client, err := hazelcast.StartNewClientWithConfig(ctx, config) // handle client start error


Hazelcast Go Client documentation is hosted at

You can view the documentation locally by using godoc:

$ godoc -http=localhost:5500

godoc is not installed by default with the base Go distribution. Install it using:

$ go get -u`


Join us at Go Client channel or Hazelcast at Google Groups.

Running the tests

Currently, we support only Linux, MacOS and WSL (Windows Subsystem for Linux) for testing the client.

You need to have the following installed in order to run integration tests: * Java 8 * Maven 3 or better * Bash * Make

Before running the tests, starts Hazelcast Remote Controller, which enables the test suite to create clusters: ```shell

Start RC with Hazelcast Community features

$ ./ start

Or, start RC with Hazelcast Enterprise features


You can run the tests using one of the following approaches: * Run

make test-all
to run integration tests. * Run
make test-all-race
to run integration tests with race detection. * Run
make test-cover
to generate the coverage report and
make view-cover
to view the test coverage summary and generate an HTML report.

Testing the client with SSL support requires running the remote controller with Hazelcast Enterprise features. To enable SSL connections, add

to environment variables, or prepend it to the make commands above.

In order to turn on verbose logging, add

to environment variables, or prepend it to the make commands above.


Apache 2 License.

Copyright (c) 2008-2021, Hazelcast, Inc. All Rights Reserved.

Visit for more information.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.