Installation

The current Gradle release is 4.10.2. You can download binaries and view docs for all Gradle versions from the ​​releases page​​.

• ​​Prerequisites​​
• ​​Additional resources​​
• ​​Install​​

• ​​Install with a package manager​​
• ​​Install manually​​

• ​​Upgrade with the Gradle Wrapper​​
• ​​Older Releases​​
• ​​Command-Line Completion​​

Prerequisites

Gradle runs on all major operating systems and requires only a ​​Java JDK or JRE​​​ version 7 or higher to be installed. To check, run ​​java -version​​:

$ java -version
java version "1.8.0_121"

Additional resources

• On-demand and live​​online training​​ is available for free to Gradle users.
• Self-paced​​tutorials​​​ are a good place to try Gradle with a variety of languages in addition to the​​docs​​.
• Gradle has a new visual build inspection tool called​​build scans​​.
• Finally, the​​Gradle Newsletter​​​ is a great way to keep​​UP-TO-DATE​​, with issues crafted monthly.

Install

Install with a package manager

​​SDKMAN!​​ is a tool for managing parallel versions of multiple Software Development Kits on most Unix-based systems.

$ sdk install gradle 4.10.2

​​Homebrew​​ is “the missing package manager for macOS”.

$ brew install gradle

​​Scoop​​ is a command-line installer for Windows inspired by Homebrew.

$ scoop install gradle

​​Chocolatey​​ is “the package manager for Windows”.

$ choco install gradle

​​MacPorts​​ is a system for managing tools on macOS:

$ sudo port install gradle

​​› Additional helpful information​​

Install manually

Step 1. ​​Download​​ the latest Gradle distribution

The current Gradle release is version 4.10.2, released on 19 Sep 2018. The distribution zip file comes in two flavors:

• ​​Binary-only​​
• ​​Complete​​, with docs and sources

If in doubt, choose the binary-only version and browse ​​docs​​​ and ​​sources​​ online.

Need to work with an older version? See the ​​releases page​​.

Step 2. Unpack the distribution

Linux & MacOS users

Unzip the distribution zip file in the directory of your choosing, e.g.:

$ mkdir /opt/gradle
$ unzip -d /opt/gradle gradle-4.10.2-bin.zip
$ ls /opt/gradle/gradle-4.10.2
LICENSE  NOTICE  bin  getting-started.html  init.d  lib  media

Microsoft Windows users

Create a new directory ​​C:\Gradle​​ with File Explorer.

Open a second File Explorer window and go to the directory where the Gradle distribution was downloaded. Double-click the ZIP archive to expose the content. Drag the content folder ​​gradle-4.10.2​​​ to your newly created ​​C:\Gradle​​ folder.

Alternatively you can unpack the Gradle distribution ZIP into ​​C:\Gradle​​ using an archiver tool of your choice.

Step 3. Configure your system environment

Linux & MacOS users

Configure your ​​PATH​​​ environment variable to include the ​​bin​​ directory of the unzipped distribution, e.g.:

$ export PATH=$PATH:/opt/gradle/gradle-4.10.2/bin

Microsoft Windows users

In File Explorer right-click on the ​​This PC​​​ (or ​​Computer​​​) icon, then click ​​Properties​​​ -> ​​Advanced System Settings​​​ -> ​​Environmental Variables​​.

Under ​​System Variables​​​ select ​​Path​​​, then click ​​Edit​​​. Add an entry for ​​C:\Gradle\gradle-4.10.2\bin​​. Click OK to save.

Step 4. Verify your installation

Open a console (or a Windows command prompt) and run ​​gradle -v​​ to run gradle and display the version, e.g.:

$ gradle -v

------------------------------------------------------------
Gradle 4.10.2
------------------------------------------------------------

​​› Additional helpful information​​

Upgrade with the Gradle Wrapper

If your existing Gradle-based build uses the ​​Gradle Wrapper​​​, you can easily upgrade by running the ​​wrapper​​ task, specifying the desired Gradle version:

$ ./gradlew wrapper --gradle-version=4.10.2 --distribution-type=bin

Note that it is not necessary for Gradle to be installed to use the Gradle wrapper. The next invocation of ​​gradlew​​​ or ​​gradlew.bat​​ will download and cache the specified version of Gradle.

$ ./gradlew tasks
Downloading https://services.gradle.org/distributions/gradle-4.10.2-bin.zip
...

​​› Additional helpful information​​

Older Releases

You can find all releases and their checksums on the ​​releases page​​.

Command-Line Completion

​​Command-line completion​​ scripts are available for bash and zsh. This provides completion for Gradle tasks and command-line options.