Skip to content


Subversion checkout URL

You can clone with
Download ZIP
The Software Development Kit Manager
Shell Groovy Cucumber JavaScript

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

GVM the Groovy enVironment Manager

GVM 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 GVM Project Page.

Please report any bugs and feature request on the GitHub Issue Tracker.

Questions and discussions at the Nabble Forum.


Open your favourite terminal and enter the following:

curl -s | bash

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

Running the Cucumber Features

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


or to see the output

./gradlew -i

Please enusre that the JAVA_HOME environment variable set to JDK 1.7 on you 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.7)

Running the Server locally

It is useful to run the server locally for development purposes. Working installations of MongoDB and vert.x are required to get going. GVM can be used to install vert.x, otherwise install it manually as described on the install page.

gvm install vert.x

Next, install MongoDB as described here. After installing, the database needs to be primed with some data. The following lines may be run with mongod running as a separate process.

$ mongo gvm
> db.candidates.insert({candidate:"groovy", default:"2.0.6"})
> db.versions.insert({candidate:"groovy", version:"2.0.5", url:""})
> db.versions.insert({candidate:"groovy", version:"2.0.6", url:""})

This will:

  • create a new gvm database
  • the Groovy candidate in the candidates collection defaulting to version 2.0.6
  • new versions in the versions collection.

Add any other candidates that you might require.

The database may be configured in the mongo.json file in the root folder of the project. If no file is found, it will assume sensible defaults for a local mongodb installation. The file should be structured as follows:


Next, prepare the local GVM environment by stepping into the cloned gvm folder, then building and starting the server.

cd /path/to/gvm

This will start the server on localhost:8080

To make your local GVM installation work with your local server, run the following commands:

./gradlew install
source ~/.gvm/bin/
Something went wrong with that request. Please try again.