Installation

Installation via Leiningen

To install Immutant via the Leiningen plugin, you'll need to first install Leiningen, followed by the lein-immutant plugin.

Install the plugin by adding it to the plugin list in ~/.lein/profiles.clj: {:user {:plugins [[lein-immutant "0.18.1"]]}}

You can determine the current version of the plugin by looking at its page on clojars. Note: the plugin requires Leiningen 2.0.0 or greater.

The plugin provides a number of subtasks, one of which is install. So installing Immutant is as easy as this: $ lein immutant install [--full] [VERSION]

Without a VERSION specified, the latest successful incremental build will be installed. To obtain fixes released in subsequent incremental builds, Simply run install again.

To obtain a specific version, you can specify an incremental build number (ex: 123) or a released version (ex: 0.10.0). Note: installing a released version requires version 0.6.0 or newer of the plugin.

The plugin will install the slim version by default. To install the full distribution, pass the --full option to the install subtask.

Releases installed via the plugin are installed by default under ~/.lein/immutant/releases, and ~/.lein/immutant/current is linked to that release. You can specify an alternative parent install directory by passing it as the third argument to install: $ lein immutant install 0.10.0 /path/where/you/want/it The plugin will install Immutant there, and link ~/.lein/immutant/current to that version.

Installation via Zip Download

You can manually download any of the same builds that you can install via the plugin as either a slim or full distribution. You can download incremental builds from the builds page and official releases from the releases page.

Once you have the zip downloaded, expand it somewhere handy. If you want to use the Leiningen plugin with this build, you'll need to set $IMMUTANT_HOME: $ mkdir immutant-releases $ cd immutant-releases $ unzip path/to/immutant-dist-{slim,full}.zip $ export IMMUTANT_HOME=~/immutant-releases/0.10.0/

The Distribution Types

Starting with release 0.9.0 (and incremental build 750), there are two release distributions available:

• slim - a smaller, lighter weight distribution that only includes the functionality needed to run Immutant Clojure applications, but not JavaEE applications.
• full - the full JBossAS distribution with Immutant included. If you need to run JavaEE applications alongside Clojure apps in the same AS, this is the distribution for you.

Older releases and builds only provide a bin distribution, which is analogous to the full distribution above.