.. _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 is now hosted on Maven Central. However, it still depends on several third-party libraries only available
in other repositories. To include GeoMesa in your project, add the following repositories to your pom:
.. code-block:: xml
boundlessgeo
https://repo.boundlessgeo.com/main
osgeo
https:///repo.osgeo.org/repository/release
and then include the desired ``geomesa-*`` dependencies:
.. code-block:: xml
org.locationtech.geomesa
geomesa-utils_2.11
2.0.0-m.1
Snapshot artifacts are available in the LocationTech snapshots repository:
.. 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/master.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`.
Legal Review
------------
GeoMesa is part of the Locationtech working group at Eclipse. The Eclipse legal team fully reviews
each major release for IP concerns. The latest release which has been fully reviewed by Eclipse Legal
is GeoMesa |eclipse_release|.
.. warning::
Eclipse releases may not contain all the bug fixes and improvements from the latest release.
* Release distribution: |eclipse_release_tarball|
* Source: |eclipse_release_source_tarball|