3. Versions and Downloads

Note

The current recommended version of GeoMesa is 5.1.0.

GeoMesa requires Java to run. GeoMesa supports Java LTS versions 11 and 17.

3.1. Release Distributions

GeoMesa release distributions contain binary artifacts for using GeoMesa. They can be downloaded from GitHub.

3.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:

<properties>
  <geomesa.version>5.1.0</geomesa.version>
  <scala.binary.version>2.12</scala.binary.version>
</properties>
<dependency>
  <groupId>org.locationtech.geomesa</groupId>
  <artifactId>geomesa-utils_${scala.binary.version}</artifactId>
  <version>${geomesa.version}</version>
</dependency>

GeoMesa provides a bill-of-materials module, which can simplify version management:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.locationtech.geomesa</groupId>
      <artifactId>geomesa-bom_${scala.binary.version}</artifactId>
      <version>${geomesa.version}</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

For cutting-edge development, 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>

3.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

3.4. Upgrading

For details on changes between versions, see the Upgrade Guide.