diff --git a/docs/getting-started/android/setup.md b/docs/getting-started/android/setup.md
index 45d51e97bf..7e91a9c88b 100644
--- a/docs/getting-started/android/setup.md
+++ b/docs/getting-started/android/setup.md
@@ -6,6 +6,27 @@
 
 ## Setting up _fastlane_
 
+Android Studio maintains its own instances of Gradle and Java, which you do not have access to in the command line. So even though you can build and run apps in Android Studio, you need to install those tools for fastlane separately. Additionally, you need to install Java _8_ and not a later version of Java, which do not play well with Gradle.
+
+### Install Java 8
+For macOS, the easiest way to install Java 8 is with [Homebrew](https://brew.sh/).
+
+Run the following commands in the terminal:
+```
+brew tap caskroom/versions
+brew cask install java8
+```
+
+The terminal command: `javac -version` should now return something similar to: `javac 1.8.0_202-ea`
+
+If this is not the case, your JAVA_HOME environment variable likely refers to a more recent version of Java. The easiest way to fix this is to uninstall all Java instances which were installed via Homebrew with `brew cask uninstall java` and then install Java 8 with `brew cask install java8`
+
+### Install Gradle
+
+On macOS you can install Gradle via homebrew with the command `brew install gradle`.
+
+### Configure fastlane
+
 Navigate your terminal to your project's directory and run
 
 ```no-highlight