Note: This tutorial covers Immutant 2.0.0.alpha1. The Immutant 1.x tutorials are still available here, and the 2.0.0.alpha2 (and up) tutorials are now part of the documentation as 'Guides'.

Installation of Immutant 1.x was atypical of most Clojure libraries, because that distribution included a forked JBoss AS7 app server. In Immutant 2.x, the app server is gone, so there is no installation step for The Deuce.

You simply declare the libraries as dependencies in your project, the same way you would any other Clojure library. For example:

(defproject some-project "1.2.3"
  ...
  :dependencies [[org.immutant/web "2.1.6"]
                 [org.immutant/caching "2.1.6"]
                 [org.immutant/messaging "2.1.6"]
                 [org.immutant/scheduling "2.1.6"]])

We're bringing in the artifacts piecemeal above, but we also provide an aggregate that brings them all in transitively:

(defproject some-project "1.2.3"
  ...
  :dependencies [[org.immutant/immutant "2.1.6"]])

The API docs for the latest release are always available at:

Incremental Builds

If you need cutting-edge features/fixes that aren't in the latest release, you can use an incremental build.

Our CI server publishes an incremental release for each successful build. In order to use an incremental build, you'll need to add a repository to your project.clj:

(defproject some-project "1.2.3"
  ...
  :dependencies [[org.immutant/immutant "2.x.incremental.{{BUILD_NUMBER}}"]]
  :repositories [["Immutant 2.x incremental builds"
                  "http://downloads.immutant.org/incremental/"]])

You should replace {{BUILD_NUMBER}} with the actual build number for the version you want to use. You can obtain this from our builds page.

Along with the artifacts, each CI build publishes the API docs for all of the Immutant 2.x namespaces.