The Grails Web Application Framework
Java Groovy CSS HTML Shell Python Other
Switch branches/tags
Clone or download
Failed to load latest commit information.
buildSrc/src/main/groovy package POM files into GRAILS_HOME/lib Jun 6, 2014
gradle Compiles successfully Oct 23, 2017
grails-bom Bump up webpack profile version to 1.1.3 Nov 23, 2017
grails-bootstrap Compiles successfully Oct 23, 2017
grails-codecs upgrade commons-codecs May 8, 2017
grails-console Spring 5 upgrade in progress Oct 6, 2017
grails-core Merge branch 'spring_5' Oct 23, 2017
grails-databinding Add LinkedHashSet to default collections for binding Jul 13, 2017
grails-dependencies Split GSP into separate project Apr 11, 2017
grails-docs Apply orange design to google docs Nov 16, 2017
grails-encoder Merge branch '3.1.x' into 3.2.x Jan 30, 2017
grails-gradle-model Profiles - profile repository support / read profiles from Maven repos Oct 3, 2015
grails-gradle-plugin Fix find main class task Oct 23, 2017
grails-logging Allow protected log fields in super class. Fixes #10683 Jun 19, 2017
grails-plugin-codecs Remove commons-lang dependency Apr 24, 2017
grails-plugin-controllers Compiles successfully Oct 23, 2017
grails-plugin-databinding Migrate Settings to Settings interface Apr 20, 2017
grails-plugin-datasource Tests compile Oct 23, 2017
grails-plugin-domain-class Add a new bean for validateable instead of replacing the old one Sep 8, 2017
grails-plugin-i18n Remove commons-lang dependency Apr 24, 2017
grails-plugin-interceptors Ensure service registry is wired before interceptors. Fixes #10793 Sep 11, 2017
grails-plugin-mimetypes non-final variables marked final Mar 1, 2017
grails-plugin-rest Use non-deprecated annotation Jun 19, 2017
grails-plugin-services Handle null lazyInit. Fixes #10773 Aug 16, 2017
grails-plugin-url-mappings Remove commons-lang dependency Apr 24, 2017
grails-plugin-validation Fix tests May 29, 2017
grails-shell Compiles successfully Oct 23, 2017
grails-spring Spring 5 upgrade in progress Oct 6, 2017
grails-test-suite-base Convert tests to use the new testing framework Jun 15, 2017
grails-test-suite-persistence Fix test Jun 19, 2017
grails-test-suite-uber Merge branch '3.2.x' into 3.3.x Oct 23, 2017
grails-test-suite-web Update plugin/profile dependencies. Cleanup. Add grails-testing-suppo… Jun 19, 2017
grails-test Compiles successfully Oct 23, 2017
grails-validation Propagate properties to ConstrainedProperty bridge. Fixes #10763 Aug 16, 2017
grails-web-boot Tests compile Oct 23, 2017
grails-web-common Compiles successfully Oct 23, 2017
grails-web-databinding Fix test-suite-persistence Apr 25, 2017
grails-web-fileupload upgrade commons file upload. Fixes #10179 Oct 4, 2016
grails-web-mvc Merge branch '3.2.x' May 9, 2017
grails-web-url-mappings Compiles successfully Oct 23, 2017
grails-web Remove aspectj as runtime dependency Apr 24, 2017
media Grails Orange Logos Feb 28, 2018
travis debug broken python script Jul 16, 2016
.gitignore restructure build May 30, 2017
.travis.yml Use trusty travis environment Oct 6, 2017
INSTALL ignoring test temporarily, as due to infrastructure issues it is not … Jun 19, 2012 Refer to Stack Overflow or Slack Apr 26, 2016
LICENSE Cleanup license Apr 27, 2017 Remove waffle, since it is not being used Apr 27, 2017
build.gradle Upgrade to 6.1.10 snapshot of GORM May 30, 2018 ignoring test temporarily, as due to infrastructure issues it is not … Jun 19, 2012
gradlew Compiles successfully Oct 23, 2017
gradlew.bat Upgrade to Gradle 3.0 Aug 23, 2016
pubring.gpg.enc Travis publishing test take 2 Mar 10, 2015
secring.gpg.enc Travis publish take 3 Mar 9, 2015
settings.gradle Remove grails-plugin-testing Jun 26, 2017
settings.xml.enc Travis publishing test take 2 Mar 10, 2015 Attempt to fix travis build Oct 23, 2017

Build Status

  • Build Status

Slack Signup


Grails is a framework used to build web applications with the Groovy programming language. The core framework is very extensible and there are numerous plugins available that provide easy integration of add-on features.

Grails is sponsored by Object Computing Inc. in St. Louis Missouri. Please contact for support inquiries.

Getting Started

You need a Java Development Kit (JDK) installed, but it is not necessary to install Groovy because it's bundled with the Grails distribution.

To install Grails, visit and download the version you would like to use. Set a GRAILS_HOME environment variable to point to the root of the extracted download and add GRAILS_HOME/bin to your executable PATH. Then in a shell, type the following:

grails create-app sampleapp
cd sampleapp
grails run-app

To build Grails, clone this GitHub repository and execute the install Gradle target:

git clone
cd grails-core
./gradlew install

If you encounter out of memory errors when trying to run the install target, try adjusting Gradle build settings. For example:

export GRADLE_OPTS="-Xmx2G -Xms2G -XX:NewSize=512m -XX:MaxNewSize=512m -XX:MaxPermSize=1G"

Performing a Release

Releases of Grails are automated by Travis CI.

To create a release perform the following steps.

First check that the tests are passing and all is well on Travis.

Next, update the Grails version in build.gradle and grails-core/src/test/groovy/grails/util/ and then push the changes to git:

$ git add build.gradle grails-core/src/test/groovy/grails/util/
$ git commit -m "Release Grails 3.0.1"
$ git tag v3.0.1
$ git push --tags
$ git push

By tagging the release Travis will perform all the necessary steps to release a new version of Grails, just wait for the build to complete.

The Travis CI build will automatically upload the tagged release to Github and be available on the Releases page.


Grails and Groovy are licensed under the terms of the Apache License, Version 2.0.

YourKit is kindly supporting Grails open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.