Downloads

First time user? The getting started guide will walk you through downloading Brooklyn, setup of your brooklyn.properties and catalog.xml files, and then trying the examples.

Download Version 0.5.0

Download File/Format checksums (?)
Distro brooklyn-dist-0.5.0-dist.zip PGP, SHA1
brooklyn-dist-0.5.0-dist.tar.gz PGP, SHA1
All Jar brooklyn-all-0.5.0-with-dependencies.jar PGP, SHA1
Release notes 0.5.0 -

Source: Maven Central

The Distro

The distribution archive contains Brooklyn as a standalone executable package.

The All Jar

This is a single JAR containing all of Brooklyn and its dependencies, for developing Brooklyn into your own applications. Just download your preferred flavour and add it to your classpath.

Release Notes

Release notes can be found here.

Examples

You can checkout the examples from the brooklyn-examples git repository. Maven (v3) is required to build them, as described here. The examples for this version (0.5.0) are in the branch 0.5.0, so if you have git and mvn already, you can simply:

% git clone https://github.com/brooklyncentral/brooklyn-examples.git
% cd brooklyn-examples
% git checkout 0.5.0
% mvn clean install

If you don't use git, you can download the projects as a tarball instead from this link. These commands should do the trick:

% curl -L -o brooklyn-examples-0.5.0.tgz \
     https://github.com/brooklyncentral/brooklyn-examples/tarball/0.5.0
% tar xvfz brooklyn-examples-0.5.0.tgz
% mv brooklyncentral-brooklyn-examples-* brooklyn-examples-0.5.0 \
     # change the strange name which github assigns in the tarball
% mvn clean install

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

Maven

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

    <dependencies>
        <dependency>
            <groupId>io.brooklyn</groupId>
            <artifactId>brooklyn-all</artifactId>
            <version>0.5.0</version>
        </dependency>
    </dependencies>

brooklyn-all (used above) brings in all dependencies, including jclouds and Apache Whirr. 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).

If you wish to use the Sonatype and/or Cloudsoft repositories (particularly for snapshots), you can add some of the following sections:

    <repositories>
        <repository>
            <id>cloudsoft-cloudfront-releases-repo</id>
            <url>http://developers.cloudsoftcorp.com/maven/releases/</url>
        </repository>
        <!-- optional for snapshot versions -->
        <repository>
            <id>sonatype-nexus-snapshots</id>
            <name>Sonatype Nexus Snapshots</name>
            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
            <releases> <enabled>false</enabled> </releases>
            <snapshots> <enabled>true</enabled> </snapshots>
        </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>

Source Code

Full source is at github.com/brooklyncentral/brooklyn. Information on working with the source is here.

Alternatively you can download archives of the source directly: