layout: website-normal title: Downloads

{% include fields.md %}

{% if site.brooklyn.is_snapshot %} The downloads on this page have not been voted on and should be used at your own risk. The latest stable release can be accessed on the main download page. {% endif %}

Download Version {{ site.brooklyn-version }}

Release Notes

Release notes can be found here.

{% comment %} TODO

Examples

Examples can be found in the main Brooklyn codebase, in the /examples directory.

A good example to start with is the Elastic Web Cluster.

{% endcomment %}

Maven

If you use Maven, you can add Brooklyn with the following in your pom:

{% highlight xml %}

<dependencies>
    <dependency>
        <groupId>org.apache.brooklyn</groupId>
        <artifactId>brooklyn-all</artifactId>
        <version>{{ site.brooklyn-version }}</version>
    </dependency>
</dependencies>

{% endhighlight %}

brooklyn-all brings in all dependencies, including jclouds. If you prefer a smaller repo you might want just brooklyn-core, brooklyn-policies, and some of brooklyn-software-webapp, brooklyn-software-database, brooklyn-software-messaging, or others (browse the full list [here]({{ this_anything_url_search }})).

If you wish to use the Apache snapshot repo, you can add this to you pom.xml:

{% highlight xml %}

<repositories>
    <repository>
        <id>apache-nexus-snapshots</id>
        <name>Apache Nexus Snapshots</name>
        <url>https://repository.apache.org/content/repositories/snapshots</url>
        <releases> <enabled>false</enabled> </releases>
        <snapshots> <enabled>true</enabled> </snapshots>
    </repository>
</repositories>

{% endhighlight %}

{% if SNAPSHOT %} Please note: to add a snapshot version of Brooklyn as a dependency to your project, you must either have Brooklyn built locally or one of these snapshot repositories in your POM. {% endif %}

Source Code

Source code is hosted at github.com/apache/brooklyn, with this version in branch [{{ site.brooklyn.git_branch }}]({{ site.brooklyn.url.git }}). These locations have a README.md in the root which explains how to get the code including submodules.

Useful information on working with the source is here.