Installing Gradle on macOS - Gradle Tutorial

Welcome to the Gradle Tutorial series, in this article we will see how to install Gradle on a Mac running macOS,


  • You should have Java JDK installed on your macOS. If not please install Java JDK 8 or above version before installing Gradle. You can check if Java is installed on your system by typing the following command in Terminal.
    code2care@mac ~ % java -version
    openjdk version "" 2020-11-04 LTS
    OpenJDK Runtime Environment Zulu11.43+1021-CA (build
    OpenJDK 64-Bit Server VM Zulu11.43+1021-CA (build, mixed mode)

    Note: I have open JDK installed on my system, you can choose to install Oracle or any other implementation.

  • Optional: If you have brew package installed, the installation will would be really quick.
  • You can check if brew is installed or not on your Mac by trying out the below command,

    code2care@mac ~ % brew --version
    Homebrew >=2.5.0 (shallow or no git repository)
    Homebrew/homebrew-core (no Git repository)

Gradle installation using Homebrew - Package Manager:

  • Run the below brew command,
    % brew install gradle

    You might get below error if Xcode Command Line tool is not installed,

    code2care@mac ~ % brew install gradle
    Error: No developer tools installed.
    Install the Command Line Tools:
      xcode-select --install

    Run the command xcode-select --install to install Command Line Tool before installing gradle.

    Once Xcode tool is installed retry the command: brew install gradle

    Check if Gradle is installed using command gradle

    code2care@mac ~ % gradle
    Welcome to Gradle 6.8.3!
    Here are the highlights of this release:
     - Faster Kotlin DSL script compilation
     - Vendor selection for Java toolchains
     - Convenient execution of tasks in composite builds
     - Consistent dependency resolution
    For more details see
    Starting a Gradle Daemon (subsequent builds will be faster)
    > Task :help
    Welcome to Gradle 6.8.3.
    To run a build, run gradle <task> ...
    To see a list of available tasks, run gradle tasks
    To see a list of command-line options, run gradle --help
    To see more detail about a task, run gradle help --task <task>
    For troubleshooting, visit

Gradle installation manually:

  1. Download the latest version of Gradle binary: v6.8.3 is the latest release as of April 2021.
  2. unzip the downloaded package in /opt/gradle directory,
    % mkdir /opt/gradle
    % unzip -d /opt/gradle
    % ls /opt/gradle/gradle-6.8.3
    LICENSE  NOTICE  bin  getting-started.html  init.d  lib  media
  3. Add Gradle installation to PATH variable,
    % export PATH=$PATH:/opt/gradle/gradle-6.8.3/bin

Validate Gradle Installation

Now that you have installed Gradle either by brew or manually, you can check if the installation is successful by running the below command,

code2care@mac ~ % gradle -v

Gradle 6.8.3

Build time:   2021-02-22 16:13:28 UTC
Revision:     9e26b4a9ebb910eaa1b8da8ff8575e514bc61c78

Kotlin:       1.4.20
Groovy:       2.5.12
Ant:          Apache Ant(TM) version 1.10.9 compiled on September 27 2020
JVM:          11.0.10 (JetBrains s.r.o 11.0.10+9)
OS:           Mac OS X 11.2.3 aarch64
Installing Gradle on macOS - Gradle Tutorial
Installing Gradle on macOS - Gradle Tutorial
Try Out Code2care Dev Tools:


Android Java Linux Microsoft Google Python macOS Notepad++ Microsoft Teams CSS PHP SharePoint Html Linux C Programs Bootstrap jQuery Sublime Android Studio Facebook Eclipse WhatsApp News MySQL Json HowTos JavaScript FTP S3


Code2care is an initiative to publish and share varied knowledge in programming and technical areas gathered during day-to-day learnings and development activities.

Students and Software Developers can leverage this portal to find solutions to their various queries without re-inventing the wheel by referring to our easy to understand posts. Technical posts might include Learnings, Tutorials, Trouble-Shooting steps, Video Tutorials, Code Snippets, How Tos, Blogs, Articles, etc.
🎉 We are celebrating the 10th years of Code2care! Thank you for all your support! We hope we made a difference.
We strong support Gender Equality & Diversity.

We stand in solidarity with Ukraine - Make a donation to UNHCR -