druid/docs/content/development/build.md

---
layout: doc_page
---

### Build from Source

Druid can be set up by building from source via git.

Building Druid requires the following:
- [JDK 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html)
  or [JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
- [Maven version 3.x](http://maven.apache.org/download.cgi)

To do so, run these commands:

```
git clone git@github.com:druid-io/druid.git
cd druid
mvn clean install
```

This will compile the project and create the Druid binary distribution tar under
`distribution/target/druid-VERSION-bin.tar.gz`.

This will also create `distribution/target/mysql-metadata-storage-bin.tar.gz`,
which is a tarball that contains the `mysql-metadata-storage` extension.

You can find the example executables in the examples/bin directory:

* run_example_server.sh
* run_example_client.sh
renaming all *.md filenames to only have lowercase and dashes so that they are editable on case-insensitive os as well 2015-05-05 17:07:32 -04:00			`---`
			`layout: doc_page`
			`---`

			`### Build from Source`

do some editing of the instructions for using mysql for metadata 2016-01-20 21:46:26 -05:00			`Druid can be set up by building from source via git.`
renaming all *.md filenames to only have lowercase and dashes so that they are editable on case-insensitive os as well 2015-05-05 17:07:32 -04:00
do some editing of the instructions for using mysql for metadata 2016-01-20 21:46:26 -05:00			`Building Druid requires the following:`
renaming all *.md filenames to only have lowercase and dashes so that they are editable on case-insensitive os as well 2015-05-05 17:07:32 -04:00			`- [JDK 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html)`
			`or [JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)`
			`- [Maven version 3.x](http://maven.apache.org/download.cgi)`

			`To do so, run these commands:`

			```
			`git clone git@github.com:druid-io/druid.git`
			`cd druid`
New extension loading mechanism 1) Remove maven client from downloading extensions at runtime. 2) Provide a way to load Druid extensions and hadoop dependencies through file system. 3) Refactor pull-deps so that it can download extensions into extension directories. 4) Add documents on how to use this new extension loading mechanism. 5) Change the way how Druid tarball is generated. Now all the extensions + hadoop-client 2.3.0 are packaged within the Druid tarball. 2015-07-07 23:51:44 -04:00			`mvn clean install`
renaming all *.md filenames to only have lowercase and dashes so that they are editable on case-insensitive os as well 2015-05-05 17:07:32 -04:00			```

			`This will compile the project and create the Druid binary distribution tar under`
New extension loading mechanism 1) Remove maven client from downloading extensions at runtime. 2) Provide a way to load Druid extensions and hadoop dependencies through file system. 3) Refactor pull-deps so that it can download extensions into extension directories. 4) Add documents on how to use this new extension loading mechanism. 5) Change the way how Druid tarball is generated. Now all the extensions + hadoop-client 2.3.0 are packaged within the Druid tarball. 2015-07-07 23:51:44 -04:00			`distribution/target/druid-VERSION-bin.tar.gz`.

do some editing of the instructions for using mysql for metadata 2016-01-20 21:46:26 -05:00			This will also create `distribution/target/mysql-metadata-storage-bin.tar.gz`,
			which is a tarball that contains the `mysql-metadata-storage` extension.
renaming all *.md filenames to only have lowercase and dashes so that they are editable on case-insensitive os as well 2015-05-05 17:07:32 -04:00
			`You can find the example executables in the examples/bin directory:`

			`* run_example_server.sh`
			`* run_example_client.sh`