The Software Development Kit Manager Command Line Interface
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 https://get.sdkman.io | 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
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
$ docker run --rm -it -v $PWD:/usr/src/app -v $HOME/.gradle:/root/.gradle sdkman-cli/gradle test
To install SDKMAN locally running against your local server, run the following commands:
$ ./gradlew install $ source ~/.sdkman/bin/sdkman-init.sh
Or run install locally with Production configuration:
$ ./gradlew -Penv=production install $ source ~/.sdkman/bin/sdkman-init.sh