This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents


Apache Geode (incubating) is a data management platform that provides real-time, consistent access to data-intensive applications throughout widely distributed cloud architectures.

Geode pools memory, CPU, network resources, and optionally local disk across multiple processes to manage application objects and behavior. It uses dynamic replication and data partitioning techniques to implement high availability, improved performance, scalability, and fault tolerance. In addition to being a distributed data container, Apache Geode is an in-memory data management system that provides reliable asynchronous event notifications and guaranteed message delivery.

Apache Geode is a mature, robust technology  originally originally developed by GemStone GemStone Systems in Beaverton, Oregon. Commercially available as GemFire™, the technology it was first widely deployed in the the financial sector as the transactional, low-latency data engine used in Wall Wall Street trading platforms.  Today Apache Geode technology is used by over 600 hundreds of enterprise customers for high-scale business applications that must meet low low latency and 24x7 availability requirements.

 This project is undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Main Concepts and Components


  • Combines redundancy, replication, and a "shared nothing" persistence architecture to deliver fail-safe reliability and performance.
  • Horizontally scalable to thousands of cache members, with multiple cache topologies to meet different enterprise needs. The cache can be distributed across multiple computers.
  • Asynchronous and synchronous cache update propagation.
  • Delta propagation distributes only the difference between old and new versions of an object (delta) instead of the entire object, resulting in significant distribution cost savings.
  • Reliable asynchronous event notifications and guaranteed message delivery through optimized, low latency distribution layer.
  • Applications run 4 to 40 times faster with no additional hardware.
  • Data awareness and real-time business intelligence. If data changes as you retrieve it, you see the changes immediately.
  • Integration with Spring Framework to speed and simplify the development of scalable, transactional enterprise applications.
  • JTA compliant transaction support.
  • Cluster-wide configurations that can be persisted and exported to other clusters.
  • Remote cluster management through HTTP.
  • REST APIs for REST-enabled application development.
  • Rolling upgrade between major version releasesupgrades may be possible, but they will be subject to any limitations imposed by new features.

Geode in 5 minutes
Geode in 5 minutes
Geode in 5 minutes

With JDK 1.8 or a more recent version installed, obtain the source archive from Geode's Github. Extract and build from source:

$ cd incubator-geode 
$ ./gradlew build installDist -Dskip.tests=true

The gradlew script downloads all dependencies needed to build Geode, including Gradle.


How to Get Apache Geode

You can download Apache Geode from the website, run a Docker image, or install with homebrew on OSX. Application developers can load dependencies from Maven Central.

Code Block


Code Block
dependencies {
  compile "org.apache.geode:geode-core:$VERSION"

Start the cluster

Download Geode by following one of the methods described above, and follow the installation instructions at in the posted manual at

With a path that contains the bin directory of the installation, start a locator and server:

$ cd gemfire-assembly/build/install/apache-geode $ ./bin/gfsh 
gfsh> start locator --name=locator 
gfsh> start server --name=server 

Create a region:

gfsh> create region --name=regionhello --type=REPLICATE 

Write a client application (this example uses a Gradle build script):


Code Block
import java.util.Map;
import comorg.gemstoneapache.gemfiregeode.cache.Region;
import comorg.gemstoneapache.gemfiregeode.cache.client.*;

public class HelloWorld {
  public static void main(String[] args) throws Exception {
    ClientCache cache = new ClientCacheFactory()
      .addPoolLocator("localhost", 10334)
    Region<String, String> region = cache
      .<String, String>createClientRegionFactory(ClientRegionShortcut.CACHING_PROXY)

    region.put("1", "Hello");
    region.put("2", "World");

    for (Map.Entry<String, String>  entry : region.entrySet()) {
      System.out.format("key = %s, value = %s\n", entry.getKey(), entry.getValue());


Compile and run The classpath should include gemfire-core-dependencies.jar.




Build and run the HelloWorld example.

$ gradle run

The application will connect to the running cluster, create a local cache, put some data in the cache, and print the cached data to the console:

key = 1, value = Hello
key = 2, value = World

Finally, shutdown the Geode server and locator:

 gfsh> shutdown --include-locators=true

For more information see the Geode Examples repository or the documentation .

Application Development

Geode applications can be written in these client technologies:

a number of client technologies:

The following libraries are available external to the Apache Geode project: