.. _versions_and_downloads: Versions and Downloads ====================== .. note:: The current recommended version of GeoMesa is |release_version|. GeoMesa requires `Java JRE or JDK 8`__ to run. __ http://www.oracle.com/technetwork/java/javase/downloads/index.html Release Distributions --------------------- GeoMesa release distributions contain pre-built artifacts for using GeoMesa. They can be downloaded from `GitHub`__. __ https://github.com/locationtech/geomesa/releases Older versions can be downloaded from the `LocationTech Maven repository`__. __ https://repo.eclipse.org/content/repositories/geomesa-releases/org/locationtech/geomesa 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: .. code-block:: xml osgeo https://repo.osgeo.org/repository/release confluent https://packages.confluent.io/maven/ and then include the desired ``geomesa-*`` dependencies: .. code-block:: xml org.locationtech.geomesa geomesa-utils_2.12 3.0.0 Nightly snapshots are available from Eclipse: .. code-block:: xml geomesa-snapshots https://repo.eclipse.org/content/repositories/geomesa-snapshots false true Source Code ----------- To build and install the source distribution requires: * `Java JDK 8 `__ * `Apache Maven `__ |maven_version| Source can be cloned using `Git `__ or downloaded from `GitHub`__. __ https://github.com/locationtech/geomesa/archive/main.tar.gz To build, change to the source directory and use Maven: .. code-block:: bash 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: .. code-block:: bash build/mvn clean install -T8 -DskipTests Upgrading --------- For details on changes between versions, see :ref:`upgrade_guide`.