kerl

Easy building and installing of Erlang/OTP instances.

Kerl aims to be shell agnostic; its only dependencies, excluding what's required to actually build Erlang/OTP, are curl and git.

Downloading

You can download the script directly from github:

$ curl -O https://github.com/evax/kerl/raw/master/kerl

Then ensure its executable

$ chmod a+x kerl

and drop it in your $PATH

How it works

Kerl keeps track of the releases it downloads, builds and installs, allowing easy installations to new destinations (without complete rebuilding) and easy switching between Erlang/OTP installations.

Usage

List the available releases (kerl ignores releases < 10):

$ ./kerl list releases
Getting the available releases from erlang.org...
R10B-0 R10B-2 R10B-3 R10B-4 R10B-5 R10B-6 R10B-7 R10B-8 R10B-9 R11B-0 R11B-1
R11B-2 R11B-3 R11B-4 R11B-5 R12B-0 R12B-1 R12B-2 R12B-3 R12B-4 R12B-5 R13A
R13B R13B01 R13B02 R13B03 R13B04 R14A R14B R14B01 R14B02
Run "./kerl update releases" to update this list from erlang.org

Pick your choice and build it:

$ kerl build R14B02 r14b02
Downloading otp_src_R14B02.tar.gz to /home/evax/.kerl/archives
(curl progresses...)
Verifying archive checksum...
(curl progresses...)
Checksum verified (229fb8f193b09ac04a57a9d7794349b7)
Extracting source code
Building Erlang/OTP R14B02 (r14b02), please wait...
Erlang/OTP R14B02 has been successfully built

Note that named builds allow you to have different builds for the same Erlang/OTP release with different configure options:

$ KERL_CONFIGURE_OPTIONS=--disable-hipe kerl build R14B02 r14b02_nohipe
Verifying archive checksum...
Checksum verified (229fb8f193b09ac04a57a9d7794349b7)
Extracting source code
Building Erlang/OTP R14B02 (r14b02_nohipe), please wait...
Erlang/OTP R14B02 (r14b02_nohipe) has been successfully built

You can verify your build has been registered:

$ kerl list builds
R14B02,r14b02
R14B02,r14b02_nohipe

To install a build:

$ kerl install r14b02
Installing Erlang/OTP R14B02 (r14b02) in ~/.kerl/installs/r14b02...
You can activate this installation running the following command:
. ~/.kerl/installs/r14b02/activate
Later on, you can leave the installation typing:
kerl_deactivate

Here again you can check the installation's been registered:

$ kerl list installations
r14b02 ~/.kerl/installs/r14b02

And at last activate it:

$ . ~/.kerl/installs/r14b02

You're now ready to work with your r14b02 installation:

$ erl -version
Erlang (SMP,ASYNC_THREADS,HIPE) (BEAM) emulator version 5.8.3

When your done just type: $ kerl_deactivate

Anytime you can check which installation, if any, is currently active with:

$ kerl active
No Erlang/OTP kerl installation is currently active

You can get an overview of the current kerl state with:

$ kerl status
Available builds:
R14B02,r14b02
R14B02,r14b02_nohipe
----------
Available installations:
r14b02 ~/.kerl/installs/r14b02
----------
Currently active installation:
The current active installation is:
~/.kerl/installs/r14b02

You can delete builds and installations with the following commands:

$ kerl delete build r14b02
The r14b02 build has been deleted

$ kerl delete installation r14b02
The installation of r14b02 has been deleted

Tuning

You can tune kerl using the .kerlrc file in your $HOME directory.

You can set the following variables:

• KERL_DOWNLOAD_DIR where to put downloaded files, defaults to $HOME/.kerl/archives

• KERL_BUILD_DIR where to hold the builds, defaults to $HOME/.kerl/builds

• KERL_INSTALL_DIR where to install, defaults to $HOME/.kerl/installs

• KERL_CONFIGURE_OPTIONS options to pass to Erlang's ./configure script, e.g. --without-termcap

• KERL_SASL_STARTUP use SASL system startup instead of minimal