The SDKMAN! Command Line Interface
Cucumber Groovy Shell


The Software Development Kit Manager Command Line Interface

Build Status Latest Version Gitter

SDKMAN is a tool for managing parallel Versions of multiple Software Development Kits on any Unix based system. It provides a convenient command line interface for installing, switching, removing and listing Candidates.

See documentation on the SDKMAN! website.

User issues can be raised on our Gitter Channel. After confirming that indeed a new bug was found, an Issue may be raised (as well as any new feature requests) on the GitHub Issue Tracker. Unfortunately we will close any Github Issues that have not followed this process.


Open your favourite terminal and enter the following:

$ curl -s | bash

If the environment needs tweaking for SDKMAN to be installed, the installer will prompt you accordingly and ask you to restart.

Running the Cucumber Features

All SDKMAN's BDD tests are written in Cucumber and can be found under src/test/cucumber/sdkman. These can be run with Gradle by running the following command:

$ ./gradlew test

Please ensure that the JAVA_HOME environment variable is set to JDK 1.8 on your system!

Mac users can add the following line to their ~/.bash_profile file to set this variable:

export JAVA_HOME=$(/usr/libexec/java_home -v1.8)

Using Docker for tests

You can run the tests in a Docker container to guarantee a clean test environment.

$ docker build --tag=sdkman-cli/gradle .
$ docker run --rm -it sdkman-cli/gradle test

By running the following command, you don't need to wait for downloading Gradle wrapper and other dependencies. The test reports can be found under the local build directory.

$ docker run --rm -it -v $PWD:/usr/src/app -v $HOME/.gradle:/root/.gradle sdkman-cli/gradle test

Local Installation

To install SDKMAN locally running against your local server, run the following commands:

$ ./gradlew install
$ source ~/.sdkman/bin/

Or run install locally with Production configuration:

$ ./gradlew -Penv=production install
$ source ~/.sdkman/bin/