.. _versions_and_downloads:
Versions and Downloads
======================
.. note::
The current recommended version of GeoMesa is |release_last|.
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.11
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`.