# 15.3. Installing GeoMesa FileSystem¶

## 15.3.1. Installing from the Binary Distribution¶

GeoMesa FileSystem artifacts are available for download or can be built from source. The easiest way to get started is to download the most recent binary version (2.1.0) from GitHub.

Extract it somewhere convenient:

$wget "https://github.com/locationtech/geomesa/releases/download/geomesa_2.11-$VERSION/geomesa-fs_2.11-$VERSION-bin.tar.gz"$ tar xvf geomesa-fs_2.11-$VERSION-bin.tar.gz$ cd geomesa-fs_2.11-$VERSION$ ls
bin/  conf/  dist/  docs/  examples/  lib/  LICENSE.txt  logs/

## 15.3.2. Building from Source¶

GeoMesa FileSystem may also be built from source. For more information refer to Building from Source in the developer manual, or to the README.md file in the the source distribution. The remainder of the instructions in this chapter assume the use of the binary GeoMesa distribution. If you have built from source, the distribution is created in the target directory of geomesa-fs/geomesa-fs-dist.

## 15.3.3. Setting up the FileSystem Command Line Tools¶

After untaring the distribution, you’ll need to either define the standard Hadoop environment variables or install Hadoop using the bin/install-hadoop.sh script provided in the tarball. Note that you will need the proper Yarn/Hadoop environment configured if you would like to run a distributed ingest job to create files.

If you are using a service such as Amazon Elastic MapReduce (EMR) or have a distribution of Apache Hadoop, Cloudera, or Hortonworks installed you can likely run something like this to configure hadoop for the tools:

$cd$GEOMESA_FS_HOME