grails Getting started with grails Grails Installation


Note: GRAILS requires a Java JDK installed (a runtime environment JRE is not sufficient) on your system, before setting up Grails. Please refer to, how to install JDK. As of this writing, it is recommended to install the latest JDK.

For Mac OSX, Linux, Cygwin, Solaris and FreeBSD:

The simplest way to manage Grails versions is using sdkman. If sdkman is installed, you can then install any version of Grails using

sdk install grails [version]

This will take care of all steps to get this right. If you skip the version, the latest version of grails will be installed. For more about using sdkman, refer to sdkman usage page.

For Linux:

    # abbreviating it using "..." for brevity
    PATH=$GRAILS_HOME/bin:$JAVA_HOME/bin: ... :$PATH

For Windows:

  1. Download a Java JDK from Oracle and install on your Windows machine. Take note of the installation folder.
  2. Download a version of Grails manually from the Downloads page.
  3. Extract the Grails file, anywhere you like.
  4. Important: You must set up 2 new environment variables JAVA_HOME and GRAILS_HOME (for Windows 10 found under *Control Panel \ System and Security \ System \ Advanced System settings \ Advanced tab \ Environment Variables) *, pointing to the extracted directories, e.g.


Value: C:\Programs\Java\jdk1.8.0_31


Value: c:\grails\grails-3.2.4

  1. Important: You must extend the Windows PATH variable to include both JAVA_HOME and GRAILS_HOME. The path variable is also found in then control panel (see 4), e.g. add the following at the end:


  1. To verify your installation is correct, open a Command Prompt and type GRAILS -VERSION. You should get something like:
| Grails Version: 3.2.4
| Groovy Version: 2.4.6
| JVM Version: 1.8.0_65