diff --git a/docs/source/getting-set-up.rst b/docs/source/getting-set-up.rst
index aef199da90..b8cd50727a 100644
--- a/docs/source/getting-set-up.rst
+++ b/docs/source/getting-set-up.rst
@@ -107,11 +107,12 @@ Mac
 
 Java
 ^^^^
-1. Open "System Preferences > Java"
-2. In the Java Control Panel, if an update is available, click "Update Now"
-3. In the "Software Update" window, click "Install Update". If required, enter your password and click "Install Helper" when prompted
-4. Wait for a pop-up window indicating that you have successfully installed the update, and click "Close"
-5. Open a new terminal and type ``java -version`` to test that Java is installed correctly
+1. Visit http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
+2. Scroll down to "Java SE Development Kit 8uXXX" (where "XXX" is the latest minor version number)
+3. Toggle "Accept License Agreement"
+4. Click the download link for jdk-8uXXX-macosx-x64.dmg (where "XXX" is the latest minor version number)
+5. Download and run the executable to install Java (use the default settings)
+6. Open a new terminal window and run ``java -version`` to test that Java is installed correctly
 
 IntelliJ
 ^^^^^^^^
@@ -173,4 +174,4 @@ By then, you'll be ready to start writing your own CorDapps. Learn how to do thi
 :doc:`flow cookbook <flow-cookbook>` and the `samples <https://www.corda.net/samples/>`_ along the way.
 
 If you encounter any issues, please see the :doc:`troubleshooting` page, or get in touch with us on the
-`forums <https://discourse.corda.net/>`_ or via `slack <http://slack.corda.net/>`_.
\ No newline at end of file
+`forums <https://discourse.corda.net/>`_ or via `slack <http://slack.corda.net/>`_.