How to...

This document will focus on Kitematic usage but the same steps apply to boot2docker for Mac OS X OR native docker running on Linux.

  1. Download and install Kitematic
  2. Run Kitematic and click on DOCKER CLI
  3. This should open a terminal window with Docker environment variables set. In order to test simply execute:

    If that's your output you're good to go. Otherwise please check your Docker Installation

  4. Pull the Apache Geode image from DockerHub:

    docker pull apachegeode/geode:nightly

    This step will take some time depending on your Internet connection since it's downloading the image for the first time.  Once it's completed you can verify by running docker images:


  5. In order to fire a new instance of this container and for example, start GFSH just execute:

    docker run -it apachegeode/geode:nightly

    The default command we have on this image is GFSH so you don't need to specify anything else and can now start a locator or a server using GFSH.

Docker-compose example

At the GitHub repository there is an example docker-compose.yml file with a Readme file explaining how to run a Geode cluster using docker-compose.  You can easily scale up and down multiple containers.

What's in the image ?

This image is based on CentOS 7, has JDK 8_u45 and a build of Geode from the source code cloning from GitHub. The exact steps can be seen the following Dockerfile.

As soon as releases start we can automate the image build and integrate the Dockerfile into Geode official repository.



  • No labels