layout: page title: Installation Guide permalink: /start/install/

Apache jclouds {{ site.latest_version }} is now available. See the [release notes](/releasenotes/{{ site.latest_version }}) for more information on the list of changes in this release.

All Apache jclouds distributions is distributed under the Apache License, version 2.0.

The link in the Mirrors column below should display a list of available mirrors with a default selection based on your inferred location. If you do not see that page, try a different browser. The checksum and signature are links to the originals on the main distribution server.

Verify the integrity

It is essential that you verify the integrity of the downloaded files using the PGP signatures and SHA checksums. Please read Verifying Apache Releases for more information on why you should verify our releases and how to do it.

The KEYS file contains the public PGP keys used by Apache jclodus developers to sign releases.

Other versions

Downloads for all versions are hosted (and mirrored) in:

You can also read the changelogs for all versions. {% endcapture %} {{ m | markdownify }}

It is very easy to install jclouds using Apache Maven. If you're new to Maven, read Maven in 5 Minutes.

If you do not have a pom.xml file, you can copy and paste the one below. If your project already has a pom.xml file, just add the dependency section below into it.

{% highlight xml %}

### Using the daily builds

If you want to use the bleeding edge release of jclouds, you‘ll need to setup a maven dependency pointing to our snapshot repository. You need to update your repositories and add the following in your project’s pom.xml:

{% highlight xml %} jclouds-snapshots https://repository.apache.org/content/repositories/snapshots true org.apache.jclouds jclouds-all {{ site.latest_snapshot }} {% endhighlight %}

Download the binaries

  • Create a pom.xml file like the one in the Maven Configuration section above.
  • Execute mvn dependency:copy-dependencies.
  • You'll notice a new directory target/dependency with all the jars you need. {% endcapture %} {{ m | markdownify }}

You can add jclouds to your project.clj like below, supporting clojure 1.2 and 1.3:

{% highlight clojure %} :dependencies [[org.clojure/clojure “1.3.0”] [org.clojure/core.incubator “0.1.0”] [org.clojure/tools.logging “0.2.3”] [org.apache.jclouds/jclouds-all “{{ site.latest_version }}”]] {% endhighlight %}

Using the daily builds

You can add jclouds snapshots to your project.clj like below:

{% highlight clojure %} :dependencies [[org.clojure/clojure “1.3.0”] [org.clojure/core.incubator “0.1.0”] [org.clojure/tools.logging “0.2.3”] [org.apache.jclouds/jclouds-all “{{ site.latest_snapshot }}”]] :repositories { “jclouds-snapshot” “https://repository.apache.org/content/repositories/snapshots”} {% endhighlight %}

### Download the binaries

  • Download lein and make it executable.
  • Create a project.clj file with the below contents. {% highlight clojure %} (defproject deps “1” :dependencies [[org.apache.jclouds/jclouds-all “{{ site.latest_version }}”] [org.apache.jclouds.driver/jclouds-sshj “{{ site.latest_version }}”]]) {% endhighlight %}
  • Execute lein pom, then mvn dependency:copy-dependencies which will fill target/dependency with all the jclouds jars.

Replace the provider and api in the above directory paths to the ones you want to use in your project. {% endcapture %} {{ m | markdownify }}

You will need to install maven ant tasks. Then, add jclouds to your build.xml as shown below:

{% highlight xml %} <artifact:dependencies pathId=“jclouds.classpath”> <dependency groupId=“org.apache.jclouds”artifactId=“jclouds-all” version=“{{ site.latest_version }}” /> </artifact:dependencies> {% endhighlight %}

Using the daily builds

You will need to install maven ant tasks. Then, add jclouds snapshot dependencies to your build.xml as shown below:

{% highlight xml %} <artifact:remoteRepository id=“jclouds.snapshot.repository” url=“https://repository.apache.org/content/repositories/snapshots” /> <artifact:dependencies pathId=“jclouds.classpath”> </artifact:dependencies> {% endhighlight %}

Download the binaries

If you want to automate fetching the jclouds binaries, you can use the following Ant script.

Install ant, copy the following into a build.xml file, tweaking things like ‘provider’ and ‘driver’ as necessary. The following example uses jclouds-all, jclouds-sshj as a driver, and includes the logback jars for a logging implementation.

When you run this script with ant, it will build a lib directory full of jars you can later copy into your own project.

{% highlight xml %} <artifact:dependencies filesetId=“jclouds.fileset” versionsId=“dependency.versions”> </artifact:dependencies> 

<get src="http://search.maven.org/remotecontent?filepath=org/apache/maven/maven-ant-tasks/2.1.3/maven-ant-tasks-2.1.3.jar"
     dest="maven-ant-tasks.jar"/>

<target name="initmvn">
    <path id="maven-ant-tasks.classpath" path="maven-ant-tasks.jar"/>
    <typedef resource="org/apache/maven/artifact/ant/antlib.xml"
         uri="urn:maven-artifact-ant"
         classpathref="maven-ant-tasks.classpath"/>
</target>

To only fetch the jars for a particular provider replace

{% highlight xml %} {% endhighlight %}

with

{% highlight xml %} {% endhighlight %} {% endcapture %} {{ m | markdownify }}