gradle.org Open in urlscan Pro
2606:4700::6810:4965  Public Scan

Form analysis
0 forms found in the DOM

Text Content

DPE University is live! Learn more about Gradle Build Tool, Gradle Build Scan,
Develocity and the ecosystem close
gradle-build-tool-dark-green-primary
 * About
   Getting Started
   Gradle Releases
   What's new in 8.0
   Features Overview
   Gradle & Maven Comparison
   Plugins
   IDE Integrations
   Declarative Gradle (EAP)
   Gradle Build Scan
 * Docs
   User Guide
   Gradle Basics
   Installing Gradle
   Languages and Frameworks
   - Gradle for Java/JVM
   - Gradle for Kotlin
   - Gradle for Android
   Developing Plugins
   Gradle Cookbook
   Contributor Guide
 * Learn
   Getting Started
   Gradle Trainings
   DPE University
   Events and Webinars
 * Get Help
   Search for Help
   Community Slack
   Community Forums
   Stack Overflow
   Commercial Services
 * Community
   Newsletter
   Blog
   Community Slack
   GitHub
   Channels and Resources
   - Community Forums
   - X/Twitter
   - LinkedIn
   - Mastodon
   - YouTube
   Contributor Guide
   Gradle Fellowship
 * Gradle Inc.
   Develocity
   Gradle Build Scan
   DPE.org
   DPE University
   Events
   Careers
 * 
 * 


INSTALLATION

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

 * Prerequisites
 * Additional resources
 * Installing with a package manager
 * Installing 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 version
8 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 visual build inspection tool: Build Scan™.
 * Finally, the Gradle Newsletter is a great way to keep UP-TO-DATE, with issues
   crafted monthly.


INSTALLING 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 8.10.1



Homebrew is “the missing package manager for macOS”.

$ brew install gradle





Other package managers are available, but the version of Gradle distributed by
them is not controlled by Gradle, Inc. Linux package managers may distribute a
modified version of Gradle that is incompatible or incomplete when compared to
the official version (available from SDKMAN! or below).

› ADDITIONAL HELPFUL INFORMATION


INSTALLING MANUALLY

STEP 1. DOWNLOAD THE LATEST GRADLE DISTRIBUTION

The current Gradle release is version 8.10.1, released on 09 Sep 2024. 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-8.10.1-bin.zip
$ ls /opt/gradle/gradle-8.10.1
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-8.10.1 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-8.10.1/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-8.10.1\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 8.10.1
------------------------------------------------------------


› 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=8.10.1 --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-8.10.1-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.

© Gradle Inc. 2024

Careers | Privacy | Terms of Service | Contact