Gretty is a feature-rich Gradle plugin for running web-apps on embedded servlet containers. It supports Jetty version 12, Tomcat version 11, multiple web-apps and many more. It wraps servlet container functions as convenient Gradle tasks and configuration DSL.

A complete list of Gretty features is available in feature overview.

You are looking at Gretty's master branch which is for Gretty 5. You also might want to look at the gretty-3.x one which is for Gretty 3 or gretty-4.x one which is for Gretty 4. They are still in development and supports older versions of Jetty and Tomcat.

Where to start

If you are new with Gretty, try getting started page.

:star: What's new

Version 5.0.2

March 13, 2026, Gretty 5.0.2 is out and available at Gradle Plugins and Maven Central.

• Fix using the deprecated archivePath property

Version 5.0.1

December 6, 2025, Gretty 5.0.1 is out and available at Gradle Plugins and Maven Central.

• Fix running Jetty 12 (thanks @codeconsole)
• Allow setting servletContainer via the command line (thanks @codeconsole)

Version 5.0.0

November 27, 2025, Gretty 5.0.0 is out and available at Gradle Plugins and Maven Central.

• Support Tomcat 11 and Jetty 12 (thanks @codeconsole)

See also: complete list of changes for more information.

Documentation

You can learn about all Gretty features in online documentation.

System requirements

Gretty requires JDK17+ and Gradle 7.0 or newer.

• Since version 2.0.0 Gretty no longer supports JDK6.
• Since version 3.0.0 Gretty no longer supports JDK7, Gradle <5.0, Tomcat 7.x or Tomcat 8.0.x.
• Since version 4.0.0 Gretty supports only JDK 11+, Gradle 6.0+, Tomcat 10.x and Jetty 11.x
• Since version 5.0.0 Gretty supports only JDK 17+, Gradle 7.0+, Tomcat 11.x and Jetty 12.x

Availability

Gretty is an open-source project and is freely available in sources as well as in compiled form.

Releases of Gretty (gretty.org fork) from 2.1.0 onwards are available at Bintray. Old releases of Gretty up to and including version 2.0.0 are available at Bintray.

Copyright and License

Copyright 2013-2020 (c) Andrey Hihlovskiy, Timur Shakurov and contributors.

All versions, present and past, of Gretty are licensed under MIT license.