---

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]({{ site.path.website }}/download/). {% endif %}

Download Version {{ site.brooklyn-version }}

The Dist

The binary distribution archive contains Brooklyn as a standalone executable package.

• [This version ZIP]({{ this_dist_url_zip }})
• [This version TGZ]({{ this_dist_url_tgz }})
• [Apache stable versions]({{ apache_releases_repo_groupid_url }}/brooklyn-dist/)
• [Apache snapshot versions]({{ apache_snapshots_repo_groupid_url }}/brooklyn-dist/)

Released versions are also available at Maven Central.

{% if site.brooklyn-version contains ‘SNAPSHOT’ %} Please note: You are reading the documentation for a snapshot version of Brooklyn. You should always confirm that the source repository and datestamp for downloaded snapshot artifacts match the intended dependencies, as snapshot artifacts change as code is written. {% endif %}

Release Notes

Release notes can be found [here]({{ site.path.guide }}/misc/release-notes.html).

{% 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 and/or Cloudsoft repositories, you can add some of the following sections:

{% 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>
    <repository>
        <id>cloudsoft-cloudfront-releases-repo</id>
        <url>http://developers.cloudsoftcorp.com/maven/releases/</url>
    </repository>
    <repository>
        <id>cloudsoft-cloudfront-snapshots-repo</id>
        <url>http://developers.cloudsoftcorp.com/maven/snapshots/</url>
        <snapshots>
            <enabled>true</enabled>
            <updatePolicy>never</updatePolicy>
            <checksumPolicy>fail</checksumPolicy>
       </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/incubator-brooklyn, with this version in branch [{{ site.brooklyn.git_branch }}]({{ site.brooklyn.url.git }}). Information on working with the source is [here]({{ site.path.guide }}/dev/code).

You can download archives of the source directly: