Documentation Contents
Java Platform, Standard Edition Installation Guide
Contents    Previous    Next

10 Installation of the JDK on macOS

The JDK supports both Intel-based (x64) and Apple Silicon (AArch64) Mac computers.

This topic includes the following sections:

System Requirements for Installing the JDK on macOS

For supported processors and browsers, see Oracle JDK 8 and JRE 8 Certified System Configurations.

Note: Installing the JDK also installs the JRE. The one exception is that the system will not replace the current JRE with a lower version. To install a lower version of the JRE, first uninstall the current version as described in "Uninstalling the JRE".

JDK Installation Instruction Notation for macOS

JDK installers now support only one version of any Java feature release. You can't install multiple versions of the same feature release.

For example, you can't install JDK 8u381 and JDK 8u371 simultaneously. If you attempt to install JDK 8u381 after JDK 8u371 is installed, the installer uninstalls JDK 8u371 and installs JDK 8u381.

Note: If you install an older version of a JDK when the newer version of the same feature family already exists, an error is displayed, prompting you to uninstall a newer JDK version if an older version has to be installed.

The JDK is installed in /Library/Java/JavaVirtualMachines/jdk-1.8.jdk regardless of the update version. For example, JDK 8u381 is installed in this directory.

The file name of the installer is either jdk-1.8_macos-arch_bin.dmg or jdk-1.8_macos-arch_bin.tar.gz, where arch is x64 for macmacOS64 systems or aarch64 for macOS aarch64 (64-bit ARM) systems.

Determining the Default JDK Version on macOS

When starting a Java application through the command line, the system uses the default JDK. There can be multiple JDKs installed on the macOS system:

You can determine which version of the JDK is the default by entering java -version in a Terminal window. If the installed version is 20 Interim 0, Update 0, and Patch 0, then you see a string that includes the text 1-8. For example:

$ java -version
java version "1.8.0_381"
Java(TM) SE Runtime Environment (build 1.8.0_381-b07)
Java HotSpot(TM) 64-Bit Server VM (build 25.381-b07, mixed mode)

To run a different version of Java, either specify the full path, or use the java_home tool. For example:

$ /usr/libexec/java_home -v 8 --exec javac -version

Installing the JDK on macOS

When you install the Java Development Kit (JDK), the associated Java Runtime Environment (JRE) is installed at the same time.

To install the JDK on macOS:

  1. Download the required JDK .dmg or .tar.gz file from Java Downloads:

    Click Accept License Agreement.

  2. From either the browser Downloads window or from the file browser, double-click the .dmg file to start it. A Finder window appears that contains an icon of an open box and the name of the .pkg file.
  3. Double-click the JDK 1.8.pkg icon to start the installation application. The installation application displays the Introduction window.
  4. Click Continue. The Installation Type window appears.
  5. Click Install. A window appears that displays the message: Installer is trying to install new software. Enter your password to allow this.
  6. Enter the Administrator user name and password and click Install Software. The software is installed and a confirmation window is displayed.

After the software is installed, you can delete the .dmg or .tar.gz file if you want to save disk space.

Uninstalling the JDK on macOS

To uninstall the JDK on macOS, you must have Administrator privileges.

Note: Do not attempt to uninstall Java by removing the Java tools from /usr/bin. This directory is part of the system software and any changes will be reset by Apple the next time that you perform an update of the OS.

  1. Go to /Library/Java/JavaVirtualMachines.
  2. Remove the directory where the JDK is installed by running the rm command as a root user or by using the sudo tool:

    $ rm -rf jdk-1.8.jdk

Installation FAQ for macOS

This topic provides answers for the following frequently asked questions about installing JDK on macOS computers.

1. How do I find out which version of Java is the system default?

When you run a Java application from the command line, it uses the default JDK. If you do not develop Java applications, then you do not need to worry about this. See Determining the Default JDK Version on macOS.

2. How do I uninstall Java?

See Uninstalling the JDK on macOS.

3. After installing Java for macOS 2012-006, can I continue to use Apple's Java 6 alongside the macOS JDK for Java 8?

If you want to continue to develop with Java 6 using the command line, then you can modify the startup script for your favorite command environment. For bash, use this:

$ export JAVA_HOME=`/usr/libexec/java_home -v 20`

Some applications use /usr/bin/java to call Java. After installing Java for macOS 2012-006, /usr/bin/java will find the newest JDK installed, and will use that for all of the Java-related command-line tools in /usr/bin. You may need to modify those applications to find Java 6, or contact the developer for a newer version of the application.

4. What happened to the Java Preferences app in Application Utilities?

The Java Preferences app was part of the Apple Java installation and is not used by Oracle Java. Therefore, macOS releases from Apple that do not include Apple Java will not include Java Preferences.

Contents    Previous    Next
Oracle and/or its affiliates Copyright © 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Contact Us