2. Versions and Downloads

Note

The current recommended version of GeoMesa is 3.0.0.

GeoMesa requires Java JRE or JDK 8 to run.

2.1. Release Distributions

GeoMesa release distributions contain pre-built artifacts for using GeoMesa. They can be downloaded from GitHub.

Older versions can be downloaded from the LocationTech Maven repository.

2.2. Maven Integration

GeoMesa artifacts are hosted on Maven Central. However, there are several required third-party libraries that are only available in other repositories. To include GeoMesa in your project, add the following repositories to your pom:

<repositories>
  <!-- geotools -->
  <repository>
    <id>osgeo</id>
    <url>https://repo.osgeo.org/repository/release</url>
  </repository>
  <!-- confluent -->
  <repository>
    <id>confluent</id>
    <url>https://packages.confluent.io/maven/</url>
  </repository>
</repositories>

and then include the desired geomesa-* dependencies:

<dependency>
  <groupId>org.locationtech.geomesa</groupId>
  <artifactId>geomesa-utils_2.11</artifactId>
  <version>3.0.0</version>
</dependency>

Nightly snapshots are available from Eclipse:

<repository>
  <id>geomesa-snapshots</id>
  <url>https://repo.eclipse.org/content/repositories/geomesa-snapshots</url>
  <releases>
    <enabled>false</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

2.3. Source Code

To build and install the source distribution requires:

Source can be cloned using Git or downloaded from GitHub.

To build, change to the source directory and use Maven:

mvn clean install

The full build takes quite a while. To speed it up, you may skip tests and use multiple threads. GeoMesa also provides the script build/mvn, which is a wrapper around Maven that downloads and runs Zinc, a fast incremental compiler:

build/mvn clean install -T8 -DskipTests

2.4. Upgrading

For details on changes between versions, see Upgrade Guide.